CAST Imaging installation on Microsoft Windows
Interactive installation process Silent installation process
Step 1 - Create a template installation file Step 2 - Run the silent installation Test access
What is installed?
Files
Windows Services Health checks Installed third-party software
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: Summary: step-by-step instructions for your CAST Imaging installation on Microsoft Windows.
Choose a location on the local machine that will be used for the CAST Imaging installation. The setup will suggest: %PROGRAMFILES%
, but you are free to choose a different location. Click to continue:
\CAST\ImagingSystem Next
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 and during the Uninstall process you chose not to remove the data in these folder, the data will be re- used.
A brief summary of the chosen options will be displayed. The installation will start when you click Install:
The installation will proceed:
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.
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
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 - and if so, ensure that any firewall rules are created to allow access on port 80/8083. Ensure you specify the correct (change
the internal network server
"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
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.
By default, a "local" authentication system is active. The default login credentials are as follows:
admin/admin (this user already has the ADMIN role and CAST recommend 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 application data access permissions if you are logged in with the "cast" user which does not have the ADMIN role):
"admin" user login:
For more information about managing authentication and permissions, see:
Configure authentication Admin Center - Users panel
"cast" user login
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)
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.
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:
For 2.0.0-beta6, if port 8083 is not free, the next available port will be used.
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:
Software Version NGINX
1.15.5 for CAST Imaging 1.9.x 1.17.6 for CAST Imaging 1.10.x
Neo4j
3.3.8 for CAST Imaging 1.2.x 3.5.0 for CAST Imaging 1.3.x 3.5.7 for CAST Imaging 1.7.x 3.5.12 for CAST Imaging 1.9.x 4.0.7 for CAST Imaging 2.0.0-funcrel 4.2.1 for CAST Imaging 2.2.0-funcrel
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).
A full list of open source software included in CAST Imaging can be found here: Open source software shipped with CAST AIP and CAST .
Imaging
