Add or removing extensions for an OSGi composition unit
Add composite bundle extensions to, or remove them from, a composition unit containing an enterprise OSGi application.
This topic assumes that we have developed a composite bundle, and added it to the internal bundle repository or to an external repository that can process composite bundles. See Develop a composite bundle.
Manage extensions for a composition unit using the administrative console as described in this topic, or by using wsadmin commands as described in Add or removing extensions for an OSGi composition unit using wsadmin commands.
After you import the enterprise bundle archive (EBA) file for the OSGi application as an asset, we can update versions of existing bundles but we cannot add extra bundles to the asset. However, after we have added the asset as a composition unit to a business-level application, we can extend the business-level application by adding one or more composite bundles to the composition unit.
You can add a composite bundle to, or remove it from, a composition unit. To update an extension to one with newer constituent bundles, you remove the composite bundle from the composition unit then add a new version of the composite bundle.
You can also view read-only information about each listed composite bundle.
- Start the administrative console.
- Navigate to Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] Extensions for this composition unit.
The Extensions for this composition unit [Collection] panel is displayed. This panel lists all the composite bundle extensions that are currently added to this composition unit. To view read-only information about a composite bundle, click the composite bundle name in the list.
- Add or remove composite bundle extensions.
- Add one or more composite bundles as extensions to a composition unit.
- In the Extensions for this composition unit [Collection] panel, click Add. The Add extensions [Collection] panel is displayed.
This panel lists all the composite bundles that are currently available to be added to the composition unit. That is, all composite bundles that are installed in an available bundle repository, and that have not already been added as a composite bundle extension or used by a deployed EBA asset. To view read-only information about a composite bundle, click the composite bundle name in the list.
- Select one or more composite bundles to add.
- Click Add. The composite bundle is added, and displayed in the list of composite bundle extensions in the Extensions for this composition unit [Collection] form.
- Remove one or more composite bundle extensions from a composition unit.
- In the Extensions for this composition unit [Collection] panel, select one or more composite bundle extensions to remove.
- Click Remove. The selected composite bundles are removed, and the updated list of composite bundle extensions is displayed.
- Save the changes to the master configuration. If we extended a deployed OSGi application, the composite bundle, including its constituent bundles, is downloaded.
What to do next
If we plan to update the composition unit at this time, check that all bundle downloads are complete. See Checking the update status of an OSGi composition unit.
Subtopics
- Add or removing extensions for an OSGi composition unit using wsadmin commands
Use the addOSGiExtension or addOSGiExtensions command to add composite bundle extensions to a composition unit containing an enterprise OSGi application. Similarly, use the removeOSGiExtension or removeOSGiExtensions command to remove composite bundle extensions. Use the listOSGiExtensions command to list all the extensions that are currently added to the composition unit.
Parent topic: Maintain an OSGi composition unit
Parent topic: Extending a deployed OSGi application
Related concepts
Composite bundles
Related tasks
Update an OSGi composition unit Modify the configuration of an OSGi composition unit Develop a composite bundle Checking the update status of an OSGi composition unit
Writing extensible OSGi applications
Related information:
Add extensions [Collection] Add extensions [Settings] Extensions for this composition unit [Collection] Extensions for this composition unit [Settings]