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 the 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.

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 containing the asset.

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

Use 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 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 using the administrative console, or using the viewCompUnit command.

• 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:

  • Use 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 ]') 
     

     For more information about using the viewCompUnit command, see the step "Display composition units and configuration settings" in topic Manage composition units using wsadmin scripting.

  The set of information about the OSGi composition unit is displayed, including the composition unit status. This status is one of the following values:

  • Use 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, we can update the asset as described in Update bundle versions for an EBA asset.

• If a new OSGi application deployment is available, we can update the OSGi composition unit so that the business-level application uses the newer configuration. See Update an OSGi composition unit.

Parent topic: Administer OSGi applications

Parent topic: Update bundle versions in a deployed OSGi application

Parent topic: Extending a deployed OSGi application

Related tasks

Update bundle versions for an EBA asset

Maintain an OSGi composition unit

Checking the bundle download status of an EBA asset

Administer bundle repositories

Export and import a deployment manifest file

Update an OSGi composition unit

Develop a composite bundle

Add or removing extensions for an OSGi composition unit

Writing extensible OSGi applications

Composition unit settings