CAST Imaging installation on Microsoft Windows

Interactive installation process

Double click the ImagingSystemSetup.exe file, provided with the installation media. You will be prompted to allow the installation - click Yes:

If your machine does not meet the minimum system requirements, the following dialog will be displayed - click YES to view the system requirements (you can continue to the installation), click NO to continue the installation:

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 CAST Imaging installation. The setup will suggest:%PROGRAMFILES%\CAST\ImagingSystem, but you are free to choose a different location. Click Next to continue:

Choose locations on the local machine that will be used to store:

  • the Neo4j database. The setup will suggest:%PROGRAMDATA%\CAST\ImagingSystem\Neo4j_data, but you are free to choose a different location.
  • the various configuration files for all components within CAST Imaging. The setup will suggest:%APPDATA%\CAST\ImagingSystem, but you are free to choose a different location.

Click Next to continue:

A list of the ports required by CAST Imaging and all its services is then displayed. You can edit any of them if you need to configure a custom port (i.e. a different service is already using the required port). Click Next to continue:

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

The installation will proceed:

The finalize screen will then be displayed - this step can take some time to complete (several minutes). Ensure you let the installation complete:

The final screen is displayed when the installation is complete:

On completion the following screen is displayed indicating that CAST Imaging has been opened in the default browser:

Silent installation process

If you need to perform a “silent” installation of CAST Imaging, please proceed as follows:

Step 1 - Create a template installation file

Create a template installation (for example a text file) that contains the information required by the CAST Imaging installer as shown below. The file can be stored anywhere on disk and should be named with the .inf extension e.g. C:\temp\imagingsetup.inf:

[Setup]
Lang=english
Dir=C:\my\installation\folder\path
Group=CAST Imaging
NoIcons=0
Tasks=
Neo4jDataDir=C:\my\data\folder\path
ConfigDir=C:\my\config\folder\path

Where:

DirPath to the installation files. The default path used by the interactive installer is C:\Program Files\CAST\ImagingSystem.
GroupThis option dictates the name of the entry that will be added to the Windows Program menu, typically this is located here %APPDATA%\Microsoft\Windows\Start Menu\Programs.
Neo4jDataDirPath to the Neo4j data storage location. The default path used by the interactive installer is C:\ProgramData\CAST\ImagingSystem\Neo4j_data.
ConfigDirPath to the CAST Imaging configuration files storage location. The default path used by the interactive installer is %APPDATA%\CAST\ImagingSystem.

Step 2 - Run the silent installation

Use the following command line from a command prompt:

ImagingSystemSetup.exe /SP- /VERYSILENT /SUPPRESSMSGBOXES /LOG="C:\temp\cast_imaging_system_setup_install.log" /LOADINF="C:\temp\imagingsetup.inf"

Where:

ImagingSystemSetup.exeThis is the installation executable provided with the installation media.
/LOGThis parameter is optional. If you use the parameter the folder specified must already exist (in the above example C:\temp must exist).
/LOADINFThis parameter indicates the location of the .inf template file created in Step 1.

Test access

Browse to the following URL to check if users can access CAST Imaging. You may wish to check that access is possible from an unrelated machine on the internal network - and if so, ensure that any firewall rules are created to allow access on port 80/8083. Ensure you specify the correct server (change “localhost” if you are testing from a remote server):

≥ 2.0.0-beta6

http://localhost:8083

≤ 2.0.0-beta5:

http://localhost

If the setup has been completed successfully, you will see the following login page in your browser:

Click to enlarge

By default, a “local” authentication system is active. The default login credentials are as follows:

  • admin/admin (CAST recommends using this initially to configure CAST Imaging).
  • cast/cast

Once logged in, you will see the following screen - this indicates that the login was successful. No applications will be visible in the list, since no data import has taken place yet. Warnings will be displayed stating that:

Installation log files

Installation log files are stored in the following locations:

%PROGRAMFILES%\CAST\ImagingSystem\logs\cast_imaging_system_setup_install_errors.log
%PROGRAMFILES%\CAST\ImagingSystem\logs\cast_imaging_system_setup_postinstall.log

What is installed?

Files

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

%PROGRAMFILES%\CAST\ImagingSystem
%PROGRAMDATA%\CAST\ImagingSystem
%APPDATA%\CAST\ImagingSystem

Windows Services

The following Windows Services will be created and set to start automatically:

Windows Service nameDocker container nameDescriptionDefault Listening PortNotes
CAST Imaging System - imaging-ETLetlCAST Imaging application management service.9001-
CAST Imaging System - Frontend servicenginxCAST Imaging front-end web service.

80 (≤ 2.0.0-beta5)

8083 (≥ 2.0.0-beta6)

From 2.1.0-funcrel this image is no longer pushed. Merged into "server".
CAST Imaging System - imaging-serviceserverCAST Imaging back-end web service.9000-
CAST Imaging System - login serviceloginCAST Imaging login and authentication service.8084From 2.1.0-funcrel this image is no longer pushed. Merged into "server".
CAST Imaging System - sourcecode servicesourcecodeCAST Imaging sourcecode service.9980From 2.1.0-funcrel this image is no longer pushed. Merged into "server".
CAST Imaging System - Neo4j Graph Databaseneo4jNeo4j Graph Database instance.6362, 7473, 7474, 7687-

Health checks

As part of the installation process, the CAST Imaging setup will check that each service is up and running. If any services are not running an error message will be displayed, for example:

The mostly likely cause of an error message indicating that a particular service is not running is that some third-party service or software is running on the same port used by the CAST Imaging service. You will need to stop any service that is using the required port and then try to manually start the CAST Imaging service again.

Installed third-party software

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

SoftwareVersion
NGINX
  • 1.15.5 for CAST Imaging ≤ 1.9.x
  • 1.17.6 for CAST Imaging 1.10.x - 2.14.0-funcrel
  • 1.22.1 for CAST Imaging ≥ 2.15.0-funcrel
Neo4j
  • 3.3.8 for CAST Imaging ≤ 1.2.x
  • 3.5.0 for CAST Imaging 1.3.x - 1.6.x
  • 3.5.7 for CAST Imaging 1.7.x - 1.8.x
  • 3.5.12 for CAST Imaging 1.9.x
  • 4.0.7 for CAST Imaging ≥ 2.0.0-funcrel - 2.1.0-funcrel
  • 4.2.1 for CAST Imaging 2.2.0-funcrel - 2.12.0-funcrel
  • 4.4.11 for CAST Imaging ≥ 2.13.0-funcrel