Installing assets using the featureManager command

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.
1. To review assets and obtain the asset feature_shortName using the featureManager command, use the featureManager find command.
  - To find assets that are applicable to your configuration, specify a string to search for:
```
featureManager find searchString
```
  - To view detailed information, use the --viewInfo option; for example:
```
featureManager find searchstring --viewInfo
```
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