featureUtility installServerFeatures
The featureUtility installServerFeatures
command installs the required features that are listed in the server.xml
file of a server.
You can use the featureUtility installServerFeatures
command to install both versioned and versionless features.
Usage example
Install the server features for the myserver
server:
featureUtility installServerFeatures myserver
Install the features for the myserver
server, which includes custom user features:
featureUtility installServerFeatures myserver --featuresBom=my.user.features:myBOM:<runtime-version>
In this example, the <runtime-version>
value is the version of the Open Liberty server where you want to install the feature, for example, 21.0.0.11
.
Syntax
Run the command from the path_to_liberty/wlp/bin
directory.
featureUtility installServerFeatures serverName [options]
- serverName
The name of the server to run the command against.
Options
Option | Description |
---|---|
--acceptLicense | Accepts the license agreement for the feature if the feature has a different license from the Liberty server into which it’s installed. |
--featuresBom | Specifies the Maven coordinates for a features BOM file. Use this option to install custom user features from a Maven repository. Ensure that the repository also contains the associated features JSON file in the same group ID as the BOM. |
--noCache | Specifies that features that are installed from a remote repository, such as Maven Central, aren’t cached locally. |
--verbose | Displays additional debug information while the action runs. |
--verify=verify_option | Specifies how features must be verified during a process or an installation. Supported values are
|
--to | Specify the extension location to install user features. If this option is not specified, the feature is installed to default |
Exit codes
The following exit codes are available for the featureUtility installServerFeatures
command:
Code | Explanation |
---|---|
0 | OK. 0 indicates successful completion of the requested operation. |
20 | 20 indicates that one or more arguments are not valid. |
21 | 21 indicates that a runtime exception occurred because of one or more of the following conditions: - A runtime exception occurred during the installation of the |
22 | 22 indicates that feature to be installed already exists. |
23 | 23 indicates that the feature definition was not valid for one or more of the following reasons: - The feature does not have a valid manifest file. - The version of the feature is not supported in this Open Liberty environment. - The |
24 | 24 indicates that the |
25 | 25 indicates that an I/O exception occurred during the installation of the |
29 | 29 indicates that the feature is not valid for the current product. |
33 | 33 indicates that the connection to the repository failed. |
37 | 37 indicates that the feature signature verification failed. |