This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Installing Features

The manual way of provisioning Carbon is 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 configurating files is a complex task. Components have inter-dependencies with other components. Some components depend on specific versions of other components.

In order to overcome these issues, WSO2 has 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.

Follow the instructions below to install new features to WSO2 Gadget Server.

1. Log on to the Gadget Server Management Console.

2. Click the "Configure" menu and select "Features."

3. In the "Feature Management" page, select the "Available Features" tab.

This section allows you to search for available features in repositories. You can select the exact repository or all available repositories from the drop-down menu. If there is no added repository, see Repository Management to add one.

4. Click on the "Find features" button. Some repositories contain multiple versions of features. If you are only interested in the latest versions, you can use the "Show only the latest versions" option.

5. You will see a list of all the features. Select the ones you want to add by marking them using check-boxes.

Tip

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". Not the already installed ones.

6. Click "Install."

Note:
If the selected repository contains features which are already installed in the system, they will not be shown under the available features list. Also, previous versions of installed features will not be shown.

7. The "Install Details" window appears.Verify the provided information and click "Next."

This page displays the size of the installation in KBs. In certain instances, the size can be 0 KB. Equinox P2 does not delete OSGi bundles when you uninstall features. Therefore, when you try to install previously uninstalled features, the size can be shown as 0. In that case, there is no need to download OSGi bundles from the repository. They are already available in your local plugins folders.

Also, some features depend on other features. For example, the "Service Hosting" feature depends on the "Service Management" feature. Therefore, in order to install the Service Hosting feature, the Service Management feature should be already installed in your system or it should be available in one of the added repositories. Otherwise Equinox P2 shows a message that the installation of Service Hosting feature cannot be performed due to a missing dependency.

8. Read and accept the terms of license agreement. Click "Next."

9. The installation process starts. It may take a few minutes to download the necessary components.

10. The installation process is complete. Click "Finish" and restart the Gadget Server for the changes to take effect.

11. You can see the changes in the Gadget Server, Management Console. For example, Databases menu shows when "Admin Console" feature is installed.