Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Users need to apply different external JAR files to the existing Carbon server, to enhance or introduce new features to the Carbon application. OSGi bundles are used to implement WSO2 Carbon. As a result, if needed to extend a platform the OSGi bundles need to be dropped into the Carbon server.

To add external libraries:

The users are allowed to apply JARs to various directories as required. The WSO2 Carbon OSGi repository is available in the <CARBONAccording to the Carbon architecture, all functionality and features available in Carbon products are built using OSGI bundles. Therefore, it is possible to extend the features available in the Carbon platform by adding new OSGI bundles to the product build. You can also add JAR files that are not OSGI bundles into the product build, which will be converted into OSGI bundles during server startup. All these OSGI bundles/JARs are stored in the OSGI repository of the product.

The WSO2 Carbon OSGI repository

The OSGI repository is located in the <PRODUCT_HOME>/repository/components directory . When extracting a Carbon or Carbon-based product, <CARBON_HOME> is the folder that gets generated.   The user has to manually insert all the corresponding entries in these components to the bundles.info file at the following location:

<CARBON_HOME>/repository/components/$profile/configuration/org.eclipse.equinox.simpleconfigurator/bundles.info  

Note that "$profile" is the default value. 

Use the following directories to drop external libraries to the Carbon Server:   directory.  The users are allowed to apply JARs/OSGI bundles to any of the following directories:

DirectoryDescription
<CARBON<PRODUCT_HOME>/repository/components/dropins

OSGi bundles which needs to be applied.

<CARBONThird-party libraries, which are already OSGI bundles.
<PRODUCT_HOME>/repository/components/libDropped JAR files that will be converted to OSGi bundles at startup and copied to the dropins directory during server startup.
<CARBON<PRODUCT_HOME>/repository/components/extensionsDropped JAR files that will be converted to OSGi Framework Extension bundles at startup and copied to the dropins directory during server startup.
After adding all the required libraries, restart the server to apply the changes
Info
Note

Note that it is not recommend to manually edit the bundles.info file of the server in the $CARBON_HOME/repository/components/default/configuration/org.eclipse.equinox.simpleconfigurator directory. The bundles.info file is updated automatically during server startup.