Install WebSphere Liberty features on an Open Liberty server

Open Liberty users with an active WAS Liberty license can install WAS Liberty features from a Maven repository.

Some WebSphere Application Server Liberty features are not available for Open Liberty servers. If we attempt to install a feature that is available only for WAS Liberty to an Open Liberty server, we 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 WAS 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, we are prompted to accept the WAS Liberty license. Accepting the license automatically converts the Open Liberty server to a WAS Liberty instance so that all WAS Liberty features are available. The edition of WAS Liberty that the server converts to depends on the features that we install. If the features are available for multiple Liberty editions, the server converts to a WAS Liberty base instance. If the features are available only for WAS Network Deployment Liberty, the server converts to a WAS Network Deployment Liberty instance. Specifying the featuresbom property directly in the featureUtility.properties file converts the server so we can install whatever WAS Liberty features we need. Running the featureUtility installFeature command with the --featuresbom option converts the server and installs the feature specified in the command from a Maven repository.

Install the features either by specifying the featuresbom property or by running the featureUtility installFeature command with the --featuresbom option. In either case, we 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 runtime-version value with the runtime version for the server where we want to install the feature, for example, 21.0.0.11.

      wlp.featuresbom=com.ibm.websphere.appserver.features:features:runtime-version

    After specifying this property and accept the license, the server is converted to a WAS Liberty instance and we can install WAS Liberty features.

  • To install a particular WAS Liberty feature by running the featureUtility installFeature command, specify the --featuresbom option. which installs the usageMetering-1.0 feature. Replace the runtime-version value with the runtime version for the server where we want to install the feature, for example, 21.0.0.11.

      featureUtility installFeature usageMetering-1.0 --featuresBom=com.ibm.websphere.appserver.features:features:runtime-version

    In this example, after accepting the license, the server is converted to a WAS Liberty base instance and the usageMetering-1.0 feature is installed from the Maven repository.

We converted the Open Liberty server to a WAS Liberty instance. We can now install any WAS Liberty feature.


See also:


Parent topic: Install Liberty