Page tree

Versions Compared

Key

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

...

Info
Summary: step-by-step instructions for installing CAST Extend Offline.
Note
Note that if you have an existing release of CAST Extend Offline installed, you do not need to remove it before running the installer. The installer will detect that the existing service exists and provided that you choose the same installation location, the service will be updatedProxy.

Download the installation media

Download the latest release of CAST Extend Offline from https://extend.castsoftware.com/#/extension?id=com.castsoftware.aip.extendservice&version=latest.

Run the setup

Double click the executable file as provided with the installation media. You may be prompted to allow the installation - click Yes:

Image Modified

The installation wizard will be displayed. Read and accept the license agreement and click Next:

Image Modified

Choose a location on the local machine that will be used for the installation. The setup will suggest: %PROGRAMFILES%\CAST\ExtendServiceExtendProxy, but you are free to choose a different location. Click Next to continue:

Image Modified

Verify and modify (if necessary) the server name and port number. This information forms CAST Extend Offline URLFill in the required information. Note that Server name and Server port will form the CAST Extend Proxy URL that needs to be configured in AIP Console or in Extension Downloader:

Image Modified

Server nameThe setup will use the server's name as defined in Windows.
Server portThe setup will use port 8085 by default. If you have another service running on this port, you are free to choose a different port number. Note that CAST Extend Offline also uses this port number by default, therefore if you already have CAST Extend Offline installed, please ensure you are not using the same port.
Your Extend emailEnter your CAST Extend credentials - these will be used to connect to CAST Extend and fetch the required extensions.
Your Extend password
Data folder location

Choose a location to store the CAST Extend Proxy data - i.e. the extensions that have been downloaded automatically or manually uploaded. The setup will suggest: %PROGRAMDATA%\CAST\ExtendProxy.

A brief summary of the chosen options will be displayed. The installation will start when you click Install:

Image Modified

The installation will proceed:

Image Modified

On completion the following screen is displayed. Click Finish:

Image RemovedA summary screen will be displayed. Please take note of the API key - this will be required when configuring AIP Console to use CAST Extend Proxy. Click Next to terminate the installation process:

Image Added

What is installed?

Files

On completion of the installation, all files related to CAST Extend Offline Proxy are stored in:

Code Block
languagetext
%PROGRAMFILES%\CAST\ExtendProxy
%PROGRAMDATA%\CAST\ExtendServiceExtendProxy

Anchor
services
services
Windows Services

The following Windows Services will be created:

Windows Service nameDescriptionListening PortAuto start?Notes
CAST_ExtendServiceExtendProxyCAST Extend Offline Proxy service8085 (default)(tick)(tick)You may need to adjust firewall rules on the server to allow incoming connections on the listening port.

Running executables

CAST Extend Offline Proxy runs under the following executables:

Code Block
languagetext
%PROGRAMFILES%\CAST\ExtendServiceExtendProxy\tools\nssm.exe
%PROGRAMFILES%\CAST\ExtendServiceExtendProxy\NodeJS\node.exe

Anchor
third
third
Installed third-party software

The following table lists all third-party software that is shipped and installed with CAST Extend OfflineProxy:

SoftwareVersion
Node.js10.15.3

Testing the installation

To test CAST Extend OfflineProxy, browse to the following location from a different machine on your local network. Change server_name and port to match your installation:

Code Block
http://<server_name>:<port>/api

If CAST Extend Offline Proxy is functioning, the following should be returned:

Code Block
<?xml version="1.0" encoding="utf-8"?>
<Offline xml:base="http://server:port" xmlns="http://www.w3.org/2007/app" xmlns:atom="http://www.w3.org/2005/Atom">
	<workspace>
		<atom:title>Default</atom:title>
			<collection href="Packages">
				<atom:title>Packages</atom:title>
			</collection>
	</workspace>
</Offline>

GUI

A GUI has been implemented for CAST Extend Offline n v. ≥ 1.1.0-beta2  - this is identical to the GUI offered in https://extend.castsoftware.com/. Browsing to http://<server>:<port> will auto redirect to http://<server>:<port>/#/search-results allowing you to browse the available extensions:

Image Removed

Unauthorized

Anchor
update
update
Updating the available extensions in CAST Extend

...

Proxy

CAST Extend Offline Proxy is provided empty in v. ≥ 1.1.0 and content must be uploaded before it can be used  but will be automatically populated when an extension is requested. It is also possible to update the content manually - see Update CAST Extend Offline Proxy with new content.

Proxy configuration

If the AIP Node/Server accessing the accessing CAST Extend Offline Proxy is configured to pass all outgoing connections through a proxy (via the Windows proxy settings or via the AIP Console settings), then you may need to whitelist the IP address/host name of the server running CAST Extend Offline in order to route connections correctly.