You can use the featureManager command to install Liberty Repository features in your Liberty environment and view required feature
information. The featureManager
find, install, and uninstall actions are
stabilized. For these actions, use the installUtility command instead.
Before you begin
Before you can access the Liberty Repository using the
featureManager command, you must install Liberty.
About this task
After you install
Liberty, you can
install
Liberty Repository features by running the
featureManager command. The
featureManager command
automatically installs asset dependencies.
Tip: Use the
installUtility
command instead of the
featureManager command. With the
installUtility command, you can manage more asset types and install, find, or
download assets from multiple repositories. For more information, see
Installing assets using the installUtility command.
Procedure
- Review the assets that are located in the Liberty Repository and obtain the
feature_shortName for each asset that you want to install. The asset feature_shortName is required to download and install assets. You
can use the featureManager command to search for and review assets, or you can
find them on the Downloads page on WASdev.net.
- To review assets and obtain the asset feature_shortName using the
featureManager command, use the featureManager find
command.
- To review assets and obtain the asset feature_shortName from the WASdev
website, see the asset details page on the WASdev website for each feature that you want to
install. The feature_shortName is found in the installation instructions of the
asset details page; for example: the Portlet Container feature_shortName is
portlet-2.0.
For a list of all Liberty features, see
Liberty features.
- Run the featureManager command to install the assets. Run the following
command:
featureManager install feature_shortName --when-file-exists=ignore
To
install multiple features, use commas to separate each feature_shortName; for
example:featureManager install feature_shortName1 feature_shortName2 --when-file-exists=ignore
To
download a feature to a local directory without installing the feature, use the
--downloadOnly option; for example:
bin/featureManager install feature_shortName1 feature_shortName2 --downloadOnly=[all|required*|none]
You
can configure this option to download all the dependent features, the dependent features required
for this runtime, or none of the dependent features. The default is to download the required
dependent features. To specify a local destination directory, use this option with the
--location=directoryPath option.To install features from a local source
directory, use the --location=directoryPath option; for
example:
bin/featureManager install feature_shortName1 feature_shortName2 --location=directoryPath
If
you do not want to connect to the Liberty Repository, use
the --offlineOnly option to install features from a local directory; for
example:
bin/featureManager install feature_shortName1 feature_shortName2 --offlineOnly --location=directoryPath
- Use the featureManager command to see what assets you have installed or to
get help. For more information, see: Liberty: featureManager command