[21.0.0.11 and later]

Installing WebSphere Liberty features on an Open Liberty server

Some WebSphere® Application Server Liberty features are not available for Open Liberty servers. Open Liberty users with an active WebSphere Application Server Liberty license can install WebSphere Application Server Liberty features from a Maven repository.

About this task

If you attempt to install a feature that is available only for WebSphere Application Server Liberty to an Open Liberty server, you might see a message similar to the following example:

CWWKF1402E: The following features were not obtained: usageMetering-1.0. Ensure that the features are valid.

Licensed WebSphere Application Server Liberty users can install these features from a Maven repository by specifying the featuresbom property or by running the featureUtility installFeature command with the --featuresbom option.

With either option, you are prompted to accept the WebSphere Application Server Liberty license. Accepting the license automatically converts your Open Liberty server to a WebSphere Application Server Liberty instance so that all WebSphere Application Server Liberty features are available. The edition of WebSphere Application Server Liberty that your server converts to depends on the features that you install. If the features are available for multiple Liberty editions, the server converts to a WebSphere Application Server (base) Liberty instance. If the features are available only for WebSphere Application Server Network Deployment Liberty, the server converts to a WebSphere Application Server Network Deployment Liberty instance.

Specifying the featuresbom property directly in your featureUtility.properties file converts your server so that you can install whatever WebSphere Application Server Liberty features you need. Running the featureUtility installFeature command with the --featuresbom option converts your server and installs the feature that is specified in the command from a Maven repository.

Procedure

Install the features either by specifying the featuresbom property or by running the featureUtility installFeature command with the --featuresbom option.
In either case, you must accept the license to proceed.
  • To install features by specifying the featuresbom property, specify the property in the featureUtility.properties file that is located in the {wlp.install.dir}/etc directory, as shown in the following example. Replace the your-runtime-version value with the runtime version for the server where you want to install the feature, for example, 21.0.0.11.
    wlp.featuresbom=com.ibm.websphere.appserver.features:features:your-runtime-version

    After you specify this property and accept the license, your server is converted to a WebSphere Application Server Liberty instance and you can install WebSphere Application Server Liberty features.

  • To install a particular WebSphere Application Server Liberty feature by running the featureUtility installFeature command, specify the --featuresbom option, as shown in the following example, which installs the usageMetering-1.0 feature. Replace the your-runtime-version value with the runtime version for the server where you want to install the feature, for example, 21.0.0.11.
    featureUtility installFeature usageMetering-1.0 --featuresBom=com.ibm.websphere.appserver.features:features:your-runtime-version

    In this example, after you accept the license, your server is converted to a WebSphere Application Server (base) Liberty instance and the usageMetering-1.0 feature is installed from the Maven repository.

Results

You converted your Open Liberty server to a WebSphere Application Server Liberty instance. You can now install any WebSphere Application Server Liberty feature.

For more information, see the featureUtility install Feature documentation on the Open Liberty website.