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 WebSphere Application Server 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: featureManager command