Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer OSGi applications > Administer bundle repositories > Administer links to external bundle repositories

Administer links to external bundle repositories using wsadmin commands

Use wsadmin commands to list, remove, add, modify, or show details for links to external bundle repositories.

Before you begin

We can administer links to external bundle repositories by using wsadmin as described in this topic, or by using the administrative console as described in Administer links to external bundle repositories.

About this task

The external bundle repositories are bundle repositories that are available outside of WAS. If your OSGi applications reference bundles that are stored in an external bundle repository, configure a link (name and URL) to the repository so that the provisioner can retrieve the bundles when required. When an OSGi application is imported as an asset, the provisioner attempts to satisfy all its dependencies by using the contents of the asset, the contents of the internal bundle repository, and the contents of any available external bundle repositories.

Depending on how the external bundle repository is implemented, you might not be able to use it to provision services, or to store composite bundles or bundles referenced by 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.

Procedure

• List all links to external bundle repositories.

  Use the listExternalBundleRepositories command. For example:

  AdminTask.listExternalBundleRepositories()
  

  For more information, see listExternalBundleRepositories command.

  The list includes any repository links that we have added since you last saved your changes, and excludes any repository links that we have removed since you last saved your changes.

• Show the configured parameters of an external bundle repository.

  Use the showExternalBundleRepository command. For example:

  AdminTask.showExternalBundleRepository('-name bundle_repository_name')
  

  For more information, see showExternalBundleRepository command.

• Remove a link to an external bundle repository.

  Use the removeExternalBundleRepository command. For example:

  AdminTask.removeExternalBundleRepository('-name bundle_repository_name')
  

  For more information, see removeExternalBundleRepository command.

• Add a link to an external bundle repository.

  Use the addExternalBundleRepository command. For example:

  AdminTask.addExternalBundleRepository('-name bundle_repository_name
                                 -url bundle_repository_URL
                                [-description bundle_repository_description]')
  

  Square brackets ("[ ]") indicate that a parameter is optional.

  For more information, see addExternalBundleRepository command.

• Modify a link to an external bundle repository.

  Use the modifyExternalBundleRepository command. For example:

  AdminTask.modifyExternalBundleRepository('-name bundle_repository_name
                                [-url bundle_repository_URL]
                                [-description bundle_repository_description]')
  

  Square brackets ("[ ]") indicate that a parameter is optional.

  For more information, see modifyExternalBundleRepository command.

What to do next

If you add, modify, or remove a link to an external bundle repository, save changes to the master configuration.

If you add or modify a link to an external bundle repository, save the changes before you can install an enterprise bundle archive (EBA) that depends on a bundle in that repository.

Subtopics

• listExternalBundleRepositories command
  Use the listExternalBundleRepositories command to list all links to external bundle repositories.
• removeExternalBundleRepository command
  Use the removeExternalBundleRepository command to remove a link to an external bundle repository.
• addExternalBundleRepository command
  Use the addExternalBundleRepository command to add a link to an external bundle repository.
• modifyExternalBundleRepository command
  Use the modifyExternalBundleRepository command to modify a link to an external bundle repository.
• showExternalBundleRepository command
  Use the showExternalBundleRepository command to show the configured parameters of an external bundle repository.

Parent topic: Administer links to external bundle repositories

Related concepts:

About OSGi Applications

Related tasks:

Secure OSGi Applications

Related reference:

OSGi Alliance RFC-0112 Bundle Repository Draft Specification
OSGi Applications: Troubleshooting tips
listExternalBundleRepositories command
removeExternalBundleRepository command
addExternalBundleRepository command
modifyExternalBundleRepository command

Related information:

External bundle repositories [Collection]
External bundle repositories [Settings]
Task topic Feedback
Copyright IBM Corporation 2009, 2011. All Rights Reserved.
This information center is powered by Eclipse technology.

+

Search Tips   |   Advanced Search