Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer OSGi applications

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

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

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

  • 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, you can update the asset as described in Update 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 Update an OSGi composition unit.

Parent topic: Administer OSGi Applications

Parent topic: Update bundle versions in a deployed OSGi application

Parent topic: Extend a deployed OSGi application

Related concepts:

About OSGi Applications

Related tasks:

Update bundle versions for an EBA asset
Maintain an OSGi composition unit
Check the bundle download status of an EBA asset
Administer bundle repositories
Export and importing a deployment manifest file
Update an OSGi composition unit
Develop a composite bundle
Add or removing extensions for an OSGi composition unit
Secure OSGi Applications

Related reference:

OSGi Applications: Troubleshooting tips
Composition unit settings
Task topic Feedback
Copyright IBM Corporation 2009, 2011. All Rights Reserved.
This information center is powered by Eclipse technology.

+

Search Tips   |   Advanced Search