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. 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.
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, a wizard prompts you to update the configuration information. You can also take the opportunity to make additional, non-essential configuration changes.For transitioning users: In the WebSphere® Application Server Version 7 Feature Pack for OSGi Applications and Java Persistence API 2.0, bundle changes to the asset are applied by restarting the business-level application, rather than by updating the composition unit. The current approach means that many bundle changes can be applied in place, without restarting the running business-level application.
This
topic describes the specific task of updating an OSGi composition
unit. The more generalized task of updating the configuration of any
composition unit is described in Updating
business-level applications.
- Start the administrative console.
- Navigate to .
The Composition unit settings panel is displayed. The deployment status is displayed under [General Properties] OSGi application deployment status,
and shows one of the following values:- Using latest OSGi application deployment.
- New OSGi application deployment not yet available because it requires
bundles that are still downloading.
- New OSGi application deployment available.
- New OSGi application deployment cannot be applied because bundle
downloads have failed.
If the status is "New OSGi application deployment available", the Update to latest deployment ... button is available.
- Update the composition unit to use the latest version of the EBA asset or composite bundle extension.
If the status is "New OSGi application deployment available",
click Update to latest deployment .... The Preview composition unit upgrade [Settings] panel is
displayed.
Because multiple updates might be available, and
because updates do not have to be applied immediately, you might not
be fully aware of the changes that you are about to make to the deployed
application. So that you can see the cumulative effect of all the changes, this panel displays the complete list, bundle by bundle, of the updates that are about to be applied. If the result is not what you want, you can cancel the update. Otherwise,
click OK.
- Update the configuration information for running the asset
or composite bundle extension in the business-level application.
Bundle changes might also require configuration changes to the composition unit. For example, if you update a bundle in an EBA asset, or replace a composite bundle extension, you might introduce a resource that requires additional configuration, such as a new or changed Blueprint resource reference, or security role mapping.
If any of the updates contain configuration options, a wizard prompts you to update the configuration information. This wizard
is based on the Set options settings wizard that
you use when creating a new OSGi composition unit. See Adding an EBA asset to a composition unit using the administrative console.
- Save your changes to the master configuration.