Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer OSGi applications
Maintain an OSGi composition unit
Whenever an enterprise bundle archive (EBA) asset is updated, you can (optionally) update the associated composition unit. You might also update a composition unit to add or remove a composite bundle extension. If any updates need configuration changes, you can also modify the configuration information for the composition unit.
About this task
An OSGi composition unit consists of an EBA asset, (optionally) one or more composite bundle extensions, and configuration information for running the asset and composite bundle extensions in a business-level application. If a new OSGi application deployment is available, you can update the OSGi composition unit so that the business-level application uses the newer configuration.
If any updates need configuration changes, you can also modify the configuration information for the composition unit. The configuration information can include HTTP session management, context roots, virtual hosts, security roles, run-as roles, and web application or Blueprint resource reference bindings for your OSGi application.
Procedure
- Add or remove composite bundle extensions for an OSGi composition unit
Use either of the following methods:
- Add or remove composite bundle extensions .
- Add or remove composite bundle extensions using wsadmin.
- Update an OSGi composition unit.
Use either of the following methods:
When all bundle downloads are complete, you can update the OSGi composition unit so that the business-level application uses the newer configuration. If any of the updates contain configuration options, you update the configuration information. We can also take the opportunity to make additional, non-essential configuration changes.
- Modify the configuration of an OSGi composition unit.
We can modify the configuration information for an OSGi composition unit at any time by using either of the following methods:
- Modify the configuration of an OSGi composition unit .
- Modify the configuration of an OSGi composition unit using wsadmin.
Results
When you save the changes to the composition unit, the associated business-level application is updated to use the new configuration. If the business-level application is running, the bundle and configuration updates are applied immediately. If possible (that is, depending on the nature of the updates) the system applies the updates without restarting the application. If you update a bundle that provides only OSGi services to the rest of the application, then only that bundle is restarted. If you update a bundle that provides one or more packages to other bundles, then those bundles and any bundles to which they provide packages are restarted. If, however, a new package or service dependency is added, or an existing package or service dependency is removed, then the application is restarted; a newly added package and service can come from a newly-provisioned bundle, or from a bundle that has already been provisioned. Messages relating to any restart operations are written to the WAS SystemOut.log file.
Subtopics
- Update an OSGi composition unit
If a new OSGi application deployment is available, you can update the OSGi composition unit so that the business-level application uses the newer configuration. If any of the updates contain configuration options, a wizard prompts you to update the configuration information.- Add or removing extensions for an OSGi composition unit
Add composite bundle extensions to, or remove them from, a composition unit that contains an enterprise OSGi application.- Modify the configuration of an OSGi composition unit
We can modify the configuration information for a composition unit that contains an enterprise OSGi application. An OSGi composition unit consists of an EBA asset, (optionally) one or more composite bundle extensions, and configuration information for running the asset and composite bundle extensions in a business-level application. The configuration information can include HTTP session management, context roots, virtual hosts, security roles, run-as roles, and web application or Blueprint resource reference bindings for your OSGi application.
Parent topic: Administer OSGi Applications
Related concepts:
About OSGi ApplicationsRelated tasks:
Update bundle versions for an EBA asset
Check the bundle download status of an EBA asset
Check the update status of an OSGi composition unit
Administer bundle repositories
Export and importing a deployment manifest file
Secure OSGi ApplicationsRelated reference:
OSGi Applications: Troubleshooting tips
Task topic Feedback
Copyright IBM Corporation 2009, 2011. All Rights Reserved.
This information center is powered by Eclipse technology.