Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer OSGi applications > Administer bundle repositories
Administer 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
We 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 as described in Administer bundles in the internal bundle repository using wsadmin.
About this task
WAS 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, add those bundles to the repository. Composite bundles can either be included directly in the 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 a EBA asset or installed in the internal bundle repository, then these elements are respected during provisioning and appropriate services are provisioned when needed. See Provisioning for OSGi applications.
We 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, 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. See Composite bundles.
We can list, delete, add, or show further details for bundles and composite bundles that are held in the internal bundle repository.
Procedure
- Start the administrative console.
- 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.
- 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.
We cannot delete a bundle if it is referenced by a composite bundle. We must delete the composite bundle first, then delete the bundle.
- To add a new bundle or composite bundle to the repository:
- Click New. The
Upload bundle [Settings] form is displayed.
- Enter the path to the bundle, composite bundle or grouped-up set of bundles 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.
- Click OK. The file is uploaded, and displayed in the list of bundles and composite bundles in the Internal bundle repository [Collection] form.
- Click New. The
Upload bundle [Settings] form is displayed.
- 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.
We cannot modify these details.
- To delete one or more bundles from the repository, select the required bundles then click Delete.
- If you added or removed a bundle or composite bundle, save changes to the master configuration.
What to do next
- If you updated a bundle or composite bundle, and to update an asset that uses it, see Update bundle versions for an EBA asset.
- If you added or updated a bundle or composite bundle, and to install an enterprise OSGi application that uses it, see Deploy an OSGi application as a business-level application.
- If you added or updated a composite bundle, and to use it to extend a composition unit, see Add or removing extensions for an OSGi composition unit.
Subtopics
- Administer bundles in the internal bundle repository using wsadmin
Use wsadmin commands to list, add, remove, or show further details for bundles and composite bundles that are held in the bundle repository that is included in the product.
Parent topic: Administer bundle repositories
Related concepts:
About OSGi Applications
Related tasks:
Move bundles from an OSGi application to a bundle repository
Administer links to external bundle repositories
Interacting with the OSGi bundle cache
Secure OSGi Applications
Related reference:
OSGi Applications: Troubleshooting tips
listLocalRepositoryBundles command
removeLocalRepositoryBundle command
removeLocalRepositoryBundles command
addLocalRepositoryBundle command
showLocalRepositoryBundle command
Related information:
Internal bundle repository [Collection]
Internal bundle repository [Settings]
Upload bundle [Settings]
Task topic
Feedback
Copyright IBM Corporation 2009, 2011. All Rights Reserved.
This information center is powered by Eclipse technology.