Downloading assets using the installUtility command

You can use the installUtility command to download assets to your local file system.

About this task

After you install Liberty, you can download assets to your local file system by running the installUtility command. Assets can be downloaded to a new directory, which you can then use as a repository, or to an existing directory-based repository. The installUtility command can access directory-based repositories both as uncompressed directories or as compressed directories in an archive file.

By default, the installUtility command is configured to download assets only from the public Liberty Repository. If you want to download 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.

Tip: Rather than downloading individual assets, you can download a wlp-featureRepo-<version>.zip file from IBM Fix Central. The .zip file contains a directory-based repository of all features and addons for the particular fix pack of Liberty that you download from IBM Fix Central. Either extract the archive file to populate a local directory-based repository or an instance of the Liberty Asset Repository Service with the feature and addon ESA files, or install assets directly from the compressed archive. Assets that are not included in the .zip file must be downloaded by using the installUtility command.

Procedure

Review the available assets and obtain the shortName for each asset that you want to download.
You can use the installUtility command to search for and review assets.
To review assets and obtain the asset shortName by 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 adminCenter:
```
installUtility find adminCenter
```
- 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 adminCenter:
```
installUtility find adminCenter --type=feature
```
Run the installUtility download command to download the assets.
You must specify a target directory for the downloaded assets on the --location option.
For example, the following command downloads the adminCenter-1.0 feature to the c:\temp\download directory:
```
installUtility download adminCenter-1.0 --location=c:\temp\download
```
You can download multiple assets at once by separating each asset shortName with a space. For example, the following command downloads both the jca-1.7 feature and the adminCenter-1.0 to the c:\temp\download directory:
```
installUtility download jca-1.7 adminCenter-1.0 --location=c:\temp\download
```

What to do next

After you download assets to your local file system, you can add a local directory to your repository configuration so that you can install assets from the directory. For more information about configuring repositories, see Configuring repositories and proxy settings for the installUtility command.