CAST Extend - CAST AIP extension ecosystem
Page tree

Versions Compared

Old Version 55

changes.mady.by.user James Hurrell

Saved on

compared with

New Version Current

changes.mady.by.user James Hurrell

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CommandSub-commandDescription
[--server <uri>]-

This option is used to specify either the server you want to connect to or a folder on disk which contains a .nupkg file. If you do not use this command (it is not mandatory), then the default ExtendNG server CAST Extend server will always be used 

Remote Server

For example https://extendngextend.castsoftware.com:443/api

Folder - note that this option is to be used if you have a raw .nupkg file that requires unpacking

D:\USER_DATA\Downloads

[--username <username>]-

When connecting to a server that requires authentication (for example https://extendngextend.castsoftware.com:443/api) to download an extension (with the install option), use these two options to specify your credentials.

Info

Note that you will require an account on the remote server to authenticate when using CAST ExtendNGExtend. You can find out about registering for an account in CAST Extend website.


[--password <password>]-
listavailable|installed|upgradable|all

Use this option to produce a list of the extensions as follows:

OptionDescription
availableThis option displays all the extensions that are available on the remote server that have not already been downloaded to the local machine.
installed

This option displays all the extensions that have already been downloaded on to the local machine. Extensions are downloaded to:

No Format
%PROGRAMDATA%\CAST\CAST\Extensions


Info
Note that you can modify the download location as described in Download an extension.


upgradableThis option displays all extensions that are available on the remote server that are a more recent version of an extension that has already been downloaded to the local machine.
allThis option displays all extensions on the specified remote server, regardless of whether they have already been downloaded to the local machine or their CAST AIP version compatibility.


install

<extensionId>

[--version <version>]

[--ignore-dependencies]


Use this option to specify an extension that you want to download on to your machine. Note that you may also need to specify the --username and --password options if the remote server requires authentication

OptionDescription
<extensionId>

This option allows you to specify a particular extension for download using its ID - this is a mandatory option. The ID of a CAST AIP extension always takes the form com.castsoftware.<name>, without any version numbers. You can determine the ID of an extension using the CAST Extension Downloader in GUI mode:

Info
Note that the most recent versions of an extension's dependencies will always be downloaded alongside the extension, unless you are using the [--ignore-dependencies] option - see below.


[--version <version>]

This option allows you to specify a specific version of the extension for download using its version number. You can determine the ID of an extension using the CAST Extension Downloader in GUI mode:

Info
This option is not mandatory. When not included, the most recent version of the extension you require will always be downloaded.


[--ignore-dependencies]

This option allows you to download an extension without any dependencies. CAST only recommends using this option if you understand the implication - an extension will not function correctly without its dependencies.

Info
This option is not mandatory. When not included, the most recent versions of an extension's dependencies will always be downloaded.



uninstall

extensionId

[--version <version>]

Use this option to specify an extension that you have downloaded to your machine and that you now want to remove from your machine:

OptionDescription
extensionIdThis option allows you to specify a particular extension for removal using its ID - this is a mandatory option. The ID of a CAST AIP extension always takes the form com.castsoftware.<name>, without any version numbers. You can determine the ID of an extension using the CAST Extension Downloader in GUI mode - see same option described above.
[--version <version>]

This option allows you to specify a specific version of the extension for download using its version number. You can determine the ID of an extension using the CAST Extension Downloader in GUI mode - see same option described above.

Info
This option is not mandatory. When not included, the most recent version of the extension you require will always be deleted from your machine.



Info

Note that:

  • removing an extension will only delete the extension files on the local machine. It does not remove the extension from any CAST AIP databases/schemas that it has been installed to.
  • removing an extension only removes the specific extension. Any dependencies are left on the machine as other extensions may require them.
  • removing an extension from your machine will cause the following log message to be displayed in CAST Server Manager when CAST AIP databases/schemas that use the extension are detected:
No Format
Extension com.castsoftware.test version : 1.2.0-funcrel is not present on this machine,
and some schemas are using it. Please use ExtensionDownloader to download it and rerun Servman.



...

Code Block
languagetext
ExtensionDownloader.exe --server https://extendngextend.castsoftware.com:443/api list upgradable

...

Code Block
languagetext
ExtensionDownloader.exe --server  https://extendngextend.castsoftware.com:443/api --username JHU --password xxxxxx install com.castsoftware.test

...

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

...

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

...