Debugging bundles at run time by using the WebSphere Application Server administrative console

The WebSphere® Application Server administrative console provides panels that you can use to explore or debug a specific set of bundles running on an application server.

You can explore or debug bundles by examining the contents of OSGi frameworks. A framework contains a collection of bundles, together with the packages and services associated with the bundles. There are two types of framework:

Isolated framework: An isolated framework contains the bundles that are defined exclusively for a specific application; each OSGi application runs in its own isolated framework. In a network deployment environment, there is one isolated framework for each server on which the application is installed. If an application includes one or more composite bundles, either as part of the application, or as an extension to the application, there is a separate isolated framework for each composite bundle.
Share bundle framework: There is a shared bundle framework per server, containing all the shared bundles that are available to the applications that are installed on that server. If the applications indirectly reference one or more composite bundles through package dependencies, there is a shared bundle framework for each composite bundle.

You can find the state of the bundles in a framework, and see which bundles import or export certain packages, or which bundles register or use a particular service. You can also see the values of the headers in the bundle manifest files.

You can navigate trails through bundles, packages, and services. For example, you might navigate the following trail:

Select a package.
See which bundle exports this package.
Find out the services that this bundle registers.
Find out which other bundles use each of these services.
Explore the details of each of these bundles.

The panels have a breadcrumb trail that shows you where you are in a trail, and allows you to retrace the steps that you have taken through the trail.

Note: You can view the frameworks for an application only if the application has been started. If the application fails to start, the link to access the framework panels is not available.

The following sections describe all the panels, and the administrative console commands that you can use to display them.

Application OSGi frameworks

This panel lists all the OSGi frameworks that are associated with an application.

To view this panel in the administrative console, click the following path:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console

For details of the information that is displayed in this panel, see Application OSGi frameworks [Collection].

Bundles in OSGi framework

This panel lists all the bundles in an OSGi framework.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name
From the Packages in OSGi framework [Collection] page, or the Services in OSGi framework [Collection] page, click Framework bundles.

For details of the information that is displayed in this panel, see Bundles in OSGi framework [Collection].

Packages in OSGi framework

This panel lists all the packages in an OSGi framework.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > Framework packages
From the Bundles in OSGi framework [Collection] page, or the Services in OSGi framework [Collection] page, click Framework packages.

For details of the information that is displayed in this panel, see Packages in OSGi framework [Collection].

Services in OSGi framework

This panel lists all the services in an OSGi framework.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > Framework services
From the Packages in OSGi framework [Collection] page, or the Bundles in OSGi framework [Collection] page, click Framework services.

For details of the information that is displayed in this panel, see Services in OSGi framework [Collection].

Packages in bundle

This panel lists all the imported packages and exported packages for an OSGi bundle.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > bundle_name > Bundle packages
From the Packages in OSGi framework [Collection] page, or the Services in OSGi framework [Collection] page, click Framework bundles > bundle_name > Bundle packages.

For details of the information that is displayed in this panel, see Packages in bundle [Collection].

Services in bundle

This panel lists all the services that are registered, and all the services that are used, by an OSGi bundle.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > bundle_name > Bundle services
From the Packages in OSGi framework [Collection] page, or the Bundles in OSGi framework [Collection] page, click Framework bundles > bundle_name > Bundle services.

For details of the information that is displayed in this panel, see Services in bundle [Collection].

Bundle details

This panel shows the details of a bundle, including identification information, the values of headers in the bundle manifest file, and bundle dependencies.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > bundle_name
From the Packages in OSGi framework [Collection] page, or the Services in OSGi framework [Collection] page, click Framework bundles > bundle_name.

For details of the information that is displayed in this panel, see Bundle details [Settings].

Package details

This panel shows the details of a package, including identification information, and the bundles that export and import the package.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > Framework packages > package_name
From the Bundles in OSGi framework [Collection] page, or the Services in OSGi framework [Collection] page, click Framework packages > package_name.
From the Bundle details [Settings] page, click Bundle packages > package_name.

For details of the information that is displayed in this panel, see Package details [Settings].

Service details

This panel shows the details of a service, including identification information, the service interfaces, the bundles that have registered or that use the service, and the service properties.

To view this panel in the administrative console, click one of the following paths:

Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] OSGi application console > framework_name > Framework services > service_identifier
From the Packages in OSGi framework [Collection] page, or the Bundles in OSGi framework [Collection] page, click Framework services > service_identifier.
From the Bundle details [Settings] page, click Bundle services > service_identifier.

For details of the information that is displayed in this panel, see Service details [Settings].