Summary: This section provides information about how to download an official CAST AIP Extension or a custom extension built by a third-party (see What are extensions) using the CAST Extension Downloader

Introduction

The CAST Extension Downloader is bundled with CAST AIP Core and can be found at the root of the CAST AIP Core installation folder (ExtensionDownloader.exe).

If not already configured, CAST highly recommends that you ensure that the CAST Extension Downloader connects to the CAST Extend server (https://extendng.castsoftware.com:443/api). You can do so by using the Preferences option:

  • add or enable the CAST Extend server (https://extendng.castsoftware.com:443/api)
  • disable any other servers that may be enabled:


With the GUI

To download an extension using CAST Extension Downloader in GUI mode, please do as follows:

Launching the CAST Extension Downloader

The CAST Extension Downloader is located at the root of your CAST AIP installation folder. Double click this .exe file to launch the application:

Downloading an extension

The CAST Extension Downloader connects automatically to CAST Extend.




 


Note once downloaded you may then need to install the extension before you can use it (this depends on the type of extension). This is explained in Install an extension.

Downloading a new version of an extension

The following section describes how to download a new version of an existing extension. For this example, we have already been using a version of the AngularJS extension and we want to install a new version to take advantage of bug fixes and new Quality Rules. To do so:



Note that:

  • if any dependent extensions also have new versions available, the CAST Extension Downloader will download these automatically for you.
  • once downloaded you may then need to install the extension before you can use it (this depends on the type of extension). This is explained in Install an extension.

Where are Extensions downloaded to?

Extensions that are downloaded with the CAST Extension Downloader are downloaded to the following location on your local machine:

AIP 8.x
%PROGRAMDATA%\CAST\CAST\Extensions



Note that this location is not dependent on a release of CAST AIP, so the extensions can be installed in other releases of CAST AIP where supported.

Changing the download location and above

It is possible to modify the location that the CAST Extension Downloader will use to store the extensions. This can be advantageous in large deployments where there may be more than one installation of CAST AIP - using a network share allows all installations of CAST AIP to use the same versions of extensions:

With the CLI

  • CAST recommends using a batch script to run the CAST Extension Downloader in CLI mode.
  • Please see here for details of all CLI options and commands.

Download the most recent version of a specific extension on a specific remote server with authentication:

ExtensionDownloader.exe --server https://extendng.castsoftware.com:443/api --username JHU --password xxxxxx install com.castsoftware.test

Download a specific version of a specific extension on a specific remote server with authentication:

ExtensionDownloader.exe --server https://extendng.castsoftware.com:443/api --username JHU --password xxxxxx install com.castsoftware.test --version 1.2.0-funcrel

Download a specific version of a specific extension on a specific remote server with authentication and do not download any dependencies:

ExtensionDownloader.exe --server https://extendng.castsoftware.com:443/api --username JHU --password xxxxxx install com.castsoftware.test --version 1.2.0-funcrel --ignore-dependencies