Administering bundles in the internal bundle repository

Use the administrative console to list, delete, add, or show further details for bundles and composite bundles that are held in the bundle repository that is included in the product.

Before you begin

You can administer bundles and composite bundles in the internal bundle repository by using the administrative console as described in this topic, or by using wsadmin commands as described in Administering bundles in the internal bundle repository using wsadmin commands.

About this task

WebSphere® Application Server includes an internal bundle repository, in which you can store the bundles and composite bundles for your OSGi applications.

If your OSGi applications are configured to expect to find certain bundles in the internal bundle repository, you must add those bundles to the repository. Composite bundles can either be included directly in your applications, or provisioned from the internal bundle repository or from an external repository that can process composite bundles. If your bundle includes Blueprint XML files that specify service or reference elements, and the bundle is included in an EBA asset or installed in the internal bundle repository, then these elements are respected during provisioning and appropriate services are provisioned when needed. For more information, see Provisioning for OSGi applications.

You can install bundles singly, or you can install a set of bundles packaged as a compressed archive file with a .zip file extension. In both cases, the bundles are available individually in the repository. If you install a composite bundle in a bundle repository, and the composite bundle includes bundles by reference, you must ensure that the referenced bundles are also available in the same repository. If you use the internal bundle repository, and the composite bundle directly contains bundles, the contained bundles are not listed separately and are only available as part of the composite bundle. For more information, see Composite bundles.

You can list, delete, add, or show further details for bundles and composite bundles that are held in the internal bundle repository.

Procedure

  1. Start the administrative console.
  2. Navigate to Environment > OSGi bundle repositories > Internal bundle repository.

    The list of bundles and composite bundles stored in the internal bundle repository is displayed in the Internal bundle repository [Collection] form.

  3. Delete, add, or show details of bundles that are held in the internal bundle repository.
    • To delete one or more bundles from the repository, select the required bundles then click Delete.

      You cannot delete a bundle if it is referenced by a composite bundle. You must delete the composite bundle first, then delete the bundle.

    • To add a new bundle or composite bundle to the repository:
      1. Click New. The Upload bundle [Settings] form is displayed.
      2. Enter the path to the bundle, composite bundle or grouped-up set of bundles that you want to add. Each individual bundle must be packaged as a .jar file, and must contain a suitably-configured bundle manifest file. Each composite bundle must be packaged as a compressed archive file with a .cba file extension, and must contain a suitably-configured composite bundle manifest file. Each grouped-up set of bundles must be packaged as a compressed archive file with a .zip file extension.
      3. Click OK. The file is uploaded, and displayed in the list of bundles and composite bundles in the Internal bundle repository [Collection] form.
    • To show the details for an existing bundle or composite bundle in the repository, click the name of the bundle or composite bundle. The details are displayed in the Internal bundle repository [Settings] form. You cannot modify these details.
  4. If you added or removed a bundle or composite bundle, save your changes to the master configuration.

What to do next