Page tree
Skip to end of metadata
Go to start of metadata

Summary: step-by-step instructions for installing CAST Extend Offline.
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 updated.

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 installation

Interactive setup

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

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

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

Verify and modify (if necessary) the server name and port number. This information forms CAST Extend Offline URL:

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.

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

The installation will proceed:

On completion the following screen is displayed. Click Finish:

Silent installation

If you would prefer to run a silent installation, please use the following command line:

com.castsoftware.aip.extendservice.<version>.exe /SP- /VERYSILENT /SUPPRESSMSGBOXES /LOG="filename.log" /LOADINF="filename.inf"
/SILENTInstructs Setup to be totally silent. When Setup is totally silent the wizard, the background window and the installation progress window are not displayed. Everything else is normal, so for example error messages during installation are displayed. If you do want the progress window to be displayed, use /SILENT instead.
/LOG="filename.log"Allows you to specify a fixed path/filename to use for the log file, for example install.log. If a file with the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an error message.
/LOADINF="filename.inf"

Instructs Setup to load the settings from the specified file after having checked the command line, for example install.infThe file should be defined before running the installation, with the following syntax:

[Setup]
Lang=english
Dir=C:\Program Files\CAST\ExtendService
Group=CAST Extend Offline
NoIcons=0
Tasks=
ServerName=my_server_hostname
ServerPort=my_port_number

Modify DirServerName and ServerPort to the required values, for example:

  • Dir= the path to the installation location. CAST recommends installing to C:\Program Files\CAST\ExtendService, but you are free to change this to another location if necessary.
  • ServerName= the host name of the server on which you are installing the service.
  • ServerPort= the port number on which the service will run. CAST recommends using 8085, but you are free to change this if necessary.

Note that the Microsoft Windows UAC prompt will be displayed regardless. It is not possible to supress this.

What is installed?

Files

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

%PROGRAMFILES%\CAST\ExtendService

Windows Services

The following Windows Services will be created:

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

Running executables

CAST Extend Offline runs under the following executables:

%PROGRAMFILES%\CAST\ExtendService\tools\nssm.exe
%PROGRAMFILES%\CAST\ExtendService\NodeJS\node.exe

Installed third-party software

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

SoftwareVersion
Node.js10.15.3

Testing the installation

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

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

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

<?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:

Updating the available extensions in CAST Extend Offline

CAST Extend Offline is provided empty in v. ≥ 1.1.0 and content must be uploaded before it can be used - see Update CAST Extend Offline with new content.

Proxy configuration

If the AIP Node/Server accessing the CAST Extend Offline 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.


  • No labels