14.1. Introduction

Nexus Repository Manager supports the OSGi Bundle Repository format. The OSGi Bundle format is defined by the OSGi RFC 112 "Bundle Repository." It is a format for the distribution of OSGi bundles which includes any components that are described by the OSGi standards set forth in RFC 112. An OBR repository has a single XML file that completely describes the contents of the entire repository. Nexus Repository Manager can read this OBR repository XML and create proxy repositories that can download OSGi bundles from remote OBR repositories. Nexus Repository Manager can also act as a hosting platform for OSGi bundles. You can configure your builds to publish OSGi bundles to Nexus Repository Manager, and then expose these bundle repositories to internal or external developers using Nexus Repository Manager as a publishing and distribution platform.

Nexus Repository Manager can also act as a bridge between Maven repositories and OSGi bundle repositories. When you configure a virtual OBR repository that uses a Maven 2 repository as a source repository, Nexus Repository Manager will expose components with the appropriate metadata from the Maven repository as OSGi bundles. In this way, you can unify your OSGi and non-OSGi development efforts and publish components with the appropriate OSGi metadata to Nexus Repository Manager. Non-OSGi clients can retrieve software components from a Maven repository, and OSGi-aware clients can retrieve OSGi bundles from a virtual OBR repository.

The following sections detail the procedures for creating and managing OBR repositories.

Nexus Repository Manager has OBR support installed by default. Prior to any usage in Nexus Repository Manager OSS the Nexus OBR Plugin needs to be installed. You can download the -bundle.zip file for your specific version from the Central Repository:

Extract the file into sonatype-work/nexus/plugin-repository and restart the repository manager. Ensure to repeat the step for any upgrades.