Installing assets using the installUtility command

You can use the installUtility command to install assets in your Liberty environment and view required asset information.

About this task

After you install Liberty, you can install assets by running the installUtility command. The installUtility command automatically installs asset dependencies.

When you install fix pack 16.0.0.2 and later, all features that apply to your Liberty edition are installed by default. To install more Liberty assets, use the installUtility command. You can also use this command to remove unwanted or unneeded Liberty features.

You can install assets from the following repositories:

The Liberty Repository, a public IBM®-hosted repository that is accessible through the internet. For more information, see Liberty Repository.
The Liberty Asset Repository Service, an open source service that you can use to create an on-premises repository that is remotely accessible behind the firewall of an enterprise. For more information, see the WASdev/tool.lars project on GitHub.
Local directory-based repositories, which you create by using the installUtility download action or by downloading the wlp-featureRepo-<version>.zip file, which contains all applicable features and addons. For more information, see Downloading assets using the installUtility command.

By default, the installUtility command is configured to install assets only from the Liberty Repository. If you want to install assets from a local directory-based repository or an instance of the Liberty Asset Repository Service, you must configure these repositories in the repositories.properties file. For more information, see Configuring repositories and proxy settings for the installUtility command.

For a list of the actions and options for the installUtility command, see installUtility command.

Procedure

Review the available assets and obtain the shortName for each asset that you want to install.
You can use the installUtility command to search for and review assets.
- To review assets and obtain the asset shortName using the installUtility command, use the installUtility find command.
  - To find assets that are applicable to your configuration, use the searchString option. The following example searches for all assets that match the search string jca:
```
installUtility find jca
```
  - To find a specific type of asset, use the --type=[feature|sample|opensource|addon|all*] option. The following example searches for features that match the search string jca:
```
installUtility find jca --type=feature
```
For a list of all Liberty features, see Liberty features.
Run the installUtility install command to install the assets.
For example, the following command installs the jca-1.6 feature:
```
installUtility install jca-1.6
```
- To install multiple assets, separate each shortName with a space. For example, the following command installs both the jca-1.6 feature and the adminCenter-1.0 feature:
```
installUtility install jca-1.6 adminCenter-1.0
```
- To install assets from a single local directory-based repository, such as the wlp-featureRepo-<version>.zip from IBM Fix Central, specify the path to the repository on the --from option.
```
installUtility install jca-1.6 --from=/wlp-featureRepo-17.0.0.1.zip
```
- To install all features that apply your edition, you can install a feature bundle addon.
  Tip: To install all features that apply your Liberty edition, you can install a feature bundle addon:
  - WebSphere® Application Server Liberty Core: libertyCoreBundle
  - WebSphere Application Server (base) Liberty: baseBundle
  - WebSphere Application Server Network Deployment Liberty: ndMemberBundle for collective member servers and ndControllerBundle for collective controllers
  - WebSphere Application Server for z/OS® Liberty: zosBundle