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 thefeaturesbom
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
featuresbom
property or by
running the featureUtility installFeature command with the
--featuresbom
option. - To install features by specifying the
featuresbom
property, specify the property in thefeatureUtility.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 theusageMetering-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
For more information, see the featureUtility install Feature documentation on the Open Liberty website.