Summary: step-by-step instructions for your 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_databut you are free to choose a different location.
  • the various configuration files for all components within CAST Imaging. The setup will suggest: %APPDATA%\CAST\ImagingSystembut you are free to choose a different location.

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 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.

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.


  • 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.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 (this user already has the ADMIN role and CAST recommend using this initially to configure CAST Imaging).
  • cast/cast

For more information about managing authentication and permissions, see:

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:

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

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

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


Next steps?

You now need to configure CAST Imaging for use. Please see the Initial configuration steps for your CAST Imaging instance section for more information:

You may also wish to perform additional advanced configuration: