Page tree

Versions Compared

Key

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

...

Info
Summary: step-by-step instructions for updating the updating CAST Extend Service Offline with new content.

Introduction

The CAST Extend Service Offline (in v. ≥ 1.1.0) is delivered with a "stock" set of CAST AIP extensions (the full list for each release of CAST Extend Service can be found in the relevant Release Notes). This stock set of extensions can be enhanced to meet your organization's requirements, for example:

...

empty" without any preconfigured extensions - you will therefore need to populate Extend Offline with extensions before you can use it. In addition, you may want to update CAST Extend Offline to add new extensions or to include more recent releases of extensions that are already

...

available in Extend Offline.

The process of updating

...

 is as follows:

  • Create a new package bundle containing the extensions you require:extendng which contains the extensions you requireDownload the package using a browser
  • Upload the package bundle to update the CAST Extend Service automaticallyOffline:

When the CAST Extend Service Offline is updated with a new package bundle of extensions and extensions have already been added, a "merge" is actioned, rather than a "delete and add". This means that no extensions are ever removed, i.e.:

  • Any extensions that already exist in CAST Extend Service Offline but do not exist in the new package bundle will remain as they are in CAST Extend ServiceOffline
  • Any extensions that already exist in CAST Extend Service Offline at a given version number will remain as they are in CAST Extend Service Offline when:
    • an older version of the same extension is added to the package bundle (both versions will be available for use)
    • a newer version of the same extension is added to the package bundle (both versions will be available for use)
    • an older and a newer version of the same extension are added to the package bundle (all three versions will be available for use)
    • the same version of the extension is added to the packagebundle

What happens when

...

CAST Extend

...

Offline does not contain an extension required for analysis?

The analysis will fail during the "Content discovery" step with the following error:

Update process

...

Creating the bundle

Using ExtendCLI

See ExtendCli for more information.

Using extend.castsoftware.com

Log in to https://extendngextend.castsoftware.com and click the Create Package located Bundle located in the top right corner next to the profile icon:

...

Choose the bundle(s) you wish to include in the update package by include by toggling the slider to the enabled position:

...

Finally click the Generate Update button to build the package.bundle:

The following message will be displayed:

...

You will receive an email (sent to the email address associated with your CAST Extend login) when your package bundle is ready to download. Click the Download button to return to extend.castsoftware.com where you can start the package bundle download:

Info
  • A package bundle containing only default extensions is generally around 500MB
  • Package Bundle files will use the .extarchive file extension

Anchor
upload
upload
Upload the

...

bundle to CAST Extend

...

Offline

Via AIP Console

If you are using the CAST Extend Service Offline with AIP Console, the process of updating the CAST Extend Service Offline is handled automatically by AIP Console. Login to AIP Console with a user account that already has the Admin role and switch to the Admin Center:

Now move to the Settings panel Administration Center - System Settings panel and expand the CAST Extend option:

Click to enlarge

Image Modified

Drag and drop your downloaded package bundle in to the options screen, or click the button to choose the .extarchive file directly. The package bundle will then be uploaded and added to the CAST Extend Service Offline automatically and all new extensions added to the package bundle will be available immediately.

Via the CAST Extend

...

Offline API and curl

CAST Extend has a built in API that can be accessed in a manner of ways. It is therefore possible to upload a new package bundle using the API, for example with curl:

Code Block
curl -F "data=@<path_to_file.extarchive>" http://<server>:<port>/api/update

...

curl option -FThis causes curl to POST data using the Content-Type multipart/form-data. See https://curl.haxx.se/docs/manpage.html#-F
<path_to_file.extarchive>The path to the .extarchive package bundle file.
<server>

Form part of the URL to your on premises CAST Extend ServiceOffline. For example:

  • <server>: the local server on which CAST Extend Service Offline is installed.
  • <port>: the port number which CAST Extend Service Offline runs on. This is determined during the installation (default port number is set to 8085).
<port>

...