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:
If you are re-installing CAST Imaging on the same server:
- and you are reusing the existing %APPDATA%\CAST\ImagingSystem folder or the custom location of your choice (i.e. it was not removed during the uninstall process),
- and you have customized any of the ports listed in the Window in the previous installation,
you MUST ensure that you enter the correct customized port number into the installer, otherwise, the relevant Windows Services will fail to start when the installation completes.
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:
| Dir | Path to the installation files. The default path used by the interactive installer is C:\Program Files\CAST\ImagingSystem. |
|---|---|
| Group | This 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. |
| Neo4jDataDir | Path to the Neo4j data storage location. The default path used by the interactive installer is C:\ProgramData\CAST\ImagingSystem\Neo4j_data. |
| ConfigDir | Path to the CAST Imaging configuration files storage location. The default path used by the interactive installer is %APPDATA%\CAST\ImagingSystem. |
- White space in a path is authorized and there is no need to surround the path with quote marks.
- Windows Environment variables in a path are not permitted.
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.exe | This is the installation executable provided with the installation media. |
|---|---|
| /LOG | This parameter is optional. If you use the parameter the folder specified must already exist (in the above example C:\temp must exist). |
| /LOADINF | This 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
For more information about managing authentication see Configure authentication.
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:
- there is no SUPER ADMIN yet - see First login and become super admin
- and that no license has been provided - see Configure a license key
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 name | Docker container name | Description | Default Listening Port | Notes |
|---|---|---|---|---|
| CAST Imaging System - imaging-ETL | etl | CAST Imaging application management service. | 9001 | - |
| CAST Imaging System - Frontend service | nginx | CAST Imaging front-end web service. | 80 (≤ 2.0.0-beta5) 8083 (≥ 2.0.0-beta6) For ≥ 2.0.0-beta6, if port 8083 is not free, the next available port will be used. | From 2.1.0-funcrel this image is no longer pushed. Merged into "server". |
| CAST Imaging System - imaging-service | server | CAST Imaging back-end web service. | 9000 | - |
| CAST Imaging System - login service | login | CAST Imaging login and authentication service. | 8084 | From 2.1.0-funcrel this image is no longer pushed. Merged into "server". |
| CAST Imaging System - sourcecode service | sourcecode | CAST Imaging sourcecode service. | 9980 | From 2.1.0-funcrel this image is no longer pushed. Merged into "server". |
| CAST Imaging System - Neo4j Graph Database | neo4j | Neo4j 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.
- The software Intel(R) Graphics Command Center Service is known to run by default on port 9001 - therefore a healthcheck error message will be displayed if this software is running on your server. Disable the service to allow the CAST Imaging service to start (you will need to start the relevant CAST Imaging Service manually).
- You can reconfigure the front-end CAST Imaging Windows services to use an alternative port, for example 8081 or a secure https (443) port (see CAST Imaging - Advanced configuration).
Installed third-party software
| Software | Version |
|---|---|
| NGINX |
|
| Neo4j |
|
