This documentation is for WSO2 Carbon 4.4.0. View documentation for the latest release.
Installing Features via the UI - Carbon 4.4.0 - WSO2 Documentation
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
Skip to end of metadata
Go to start of metadata

The manual way of provisioning Carbon is by dropping bundles and configuration files that belong to a feature. This method is not recommended since it can cause errors. Besides, finding the exact set of components and configuring files is a complex task. Components have inter-dependencies with other components. Some components depend on specific versions of other components.

WSO2 Feature Repository:

The WSO2 Feature Repository consists of features that are bundled into WSO2 products that are based on a particular Carbon release. The feature repository for WSO2 products based on Carbon 4.4.x versions is

As a result, to overcome these issues WSO2 has the Equinox P2 integrated with Carbon. It enables user-friendly provisioning capabilities by allowing users to download WSO2 Carbon or any other WSO2 product and simply extend them by installing various features.

If you are on Windows, be sure to point the -Dcarbon.home property in the product's startup script (wso2server.bat) to the product's distribution home (e.g., -Dcarbon.home=C:\Users\VM\Desktop\wso2as-5.2.1). Alternatively, you can also set the carbon.home as a system property in Windows. Then, restart the server. Without this setting, you might not be able to install features through the management console.

Follow the instructions below to install new features to a WSO2 product:

  1. Log into the product's Management Console.
  2. On the Configure menu, click Features.
    The Feature Management page will appear.
  3. Click Available Features.
  4. Select a relevant repository.
    If no repositories have been added or the required repository is not available, add a new repository. For more information see, Adding a Repository.
  5. Some repositories contain multiple versions of features. If you are only interested in the latest versions, select the Show only the latest versions option.
  6. A feature category is a logical grouping of the features that constitute a particular Carbon based product. Selecting the Group features by category option enables you to easily view and select the entire list of features of a particular product at once. For more information, see Feature Categorization. If you do not select this option when looking for features, you will see an uncategorized, flat feature list from which individual features can be selected separately.
  7. Click Find Features. The available features will be listed.
  8. Select the features you wish to install.

    To find a particular feature, you can use the search function. Enter the name of a feature (or a part of the name) and press Enter
    This search will return only available features; excluding the ones already installed.

  9. Click Install.
  10. Verify the feature to be installed and click Next.
  11. Read and accept the terms of the license agreement.
  12. Click Next.
    The installation process starts. It may take a few minutes to download the necessary components.
  13. Once the installation process is complete, click Finish.
  14. Restart the server for the changes to take effect. Based on the newly added features, you will be able to see the additional functionalities.

Viewing feature information

When features of a repository are loaded, you can install them or view the corresponding feature details by clicking the More Info link associated with the respective feature. The Feature Information page will then appear with the following information:

  • Name
  • Identifier
  • Version
  • Provider
  • Description
  • Copyright
  • License Agreement

Familiarize yourself with the information and click Back to load the previous page.

  • No labels