Checking the update status of an OSGi composition unit

When you change the versions of bundles or composite bundles that an enterprise OSGi application uses, or add or remove a composite bundle extension, the bundles used by the deployed application can get out of synchronization with those bundles that are available. To check that your business-level application is running the most recent version of the EBA asset and any composite bundle extensions, you check the update status of the associated OSGi composition unit.

About this task

When an EBA asset is updated, or a composite bundle extension is added or replaced, the update does not automatically affect the running business-level application. To update the running application, you update the composition unit of the business-level application that contains the asset.

The deployment status shows whether an updated version is available of the EBA asset or composite bundle extension that is contained in the composition unit. There are four distinct deployment statuses for an OSGi composition unit:

Using latest OSGi application deployment.: The composition unit is running the latest configuration of the backing asset and any composite bundle extensions.
New OSGi application deployment not yet available because it requires bundles that are still downloading.: The bundle downloads that were started after you last updated an asset, or added a composite bundle extension, have not yet finished.
New OSGi application deployment available.: The backing asset is available at a newer configuration than the configuration that is currently running in this composition unit, or a composite bundle extension has been added or replaced.
New OSGi application deployment cannot be applied because bundle downloads have failed.: The bundle downloads that were started after you last updated an asset, or added a composite bundle extension, have not succeeded. Resolve the problem, then download the bundles again. See Interacting with the OSGi bundle cache.

You can check whether the OSGi composition unit is up to date by using the administrative console, or by using the viewCompUnit command.

Procedure

Check the update status of the OSGi composition unit using the administrative console.
1. Start the administrative console.
2. Navigate to Applications > Application Types > Business-level applications > application_name > composition_unit_name.
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.
Check the update status of the OSGi composition unit using the viewCompUnit command.
1. Open a wsadmin command prompt.
2. Run the following jython command:
```
AdminTask.viewCompUnit('[-blaID WebSphere:blaname=bla_name 
                         -cuID WebSphere:cuname=cu_name ]') 
```
The set of information about the OSGi composition unit is displayed, including the composition unit status. This status is 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.

What to do next

If there is no update in progress, or bundle downloads for the asset have not succeeded, you can update the asset as described in Updating bundle versions for an EBA asset.
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. See Updating an OSGi composition unit.