Summary: CAST Imaging can be installed on Linux and Microsoft Windows operating systems as a set of docker containers. This section explains how to install CAST Imaging.
Ensure that all requirements are in place. This includes the installation of any third-party software that is required to run CAST Imaging on Docker. Installation of third-party software is out of scope of this documentation, however, some tips can be found in the following third-party documentation: Ubuntu CentOS Microsoft Windows The CAST Imaging installation files for Docker are available as extensions published by CAST - see Docker Installer. Ensure you obtain the correct release/extension for your target release of CAST Imaging: Download the Docker Installer extension from CAST Extend and unzip it to a working folder anywhere on the server. Download the Docker Installer extension from CAST Extend using curl: Then unzip the ZIP that has been downloaded - the file can be unzipped anywhere: A set of files and folders is produced when the extension is unzipped. These files are configuration and properties files that are used by the CAST Imaging containers when they are started: Hyper-V mode for Docker Desktop on Microsoft Windows If you are using Hyper-V mode for Docker Desktop, you must ensure that you add the path to the installation files to the Resources > File Sharing tab in the Docker Desktop UI so that these files are mounted by the Linux containers. When using Docker installer ≥ 1.2.11, you should add the path to the installed files, not the unzipped files. When using Docker installer ≤ 1.2.10, you should add the path to the unzipped files. For example, if you unzipped/installed the files to D:\CAST\temp\DockerInstaller, then you need to add D:\CAST\temp\DockerInstaller to the File Sharing tab. Ensure that you click Apply and Restart so that the changes are taken into account: This change is not required when using WSL2 mode. In these releases, the Docker Installer files are first installed to a specific location and are then run from there. Run the following command to do all of the following: If you would like to install the files to a different location, use the following command instead - note that the folder MUST NOT already exist: In these older releases, the files are simply unzipped and all commands are run from the location where the files have been unzipped. Therefore, move to the folder where the Docker Installer files were unzipped and start CAST Imaging with the following command. This will pull the most recent "funcrel" release docker images of CAST Imaging and start them up: 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 8083. Ensure you specify the correct server (change "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: For more information about managing authentication and permissions, see:Step 1 - ensure deployment requirements are in place
Step 2 - download and process the installation files
CAST Imaging release Required Docker Installer release ≥ 2.15.0-beta2 Starting from 2.15.0-beta2 of CAST Imaging, the Docker Installer will be provided with every single release and should be used to install the specific release and upgrade to the specific release. ≥ 2.14.x ≥ 1.2.10-funcrel ≥ 2.13.x ≥ 1.2.9-funcrel ≥ 2.12.x ≥ 1.2.8-funcrel ≥ 2.11.x ≥ 1.2.7-funcrel ≥ 2.10.x ≥ 1.2.6-funcrel 2.7.1-funcrel - 2.9.x-funcrel 1.2.4-funcrel - 1.2.5-funcrel 2.7.x-funcrel 1.2.3-funcrel 2.5.x-funcrel - 2.6.x-funcrel 1.2.2-funcrel 2.1.x-funcrel - 2.4.0-funcrel 1.1.0-funcrel, 1.2.0-funcrel or 1.2.1-funcrel 2.0.x-funcrel 1.1.0-beta1 only Microsoft Windows
Linux
curl -O -J "https://extend.castsoftware.com/api/package/download/com.castsoftware.imaging.docker" -H "x-nuget-apikey: <key>" -H "accept: application/octet-stream"
unzip com.castsoftware.imaging.docker.1.2.11-funcrel.zip
Step 3 - initial install and start-up
Files:
.env
docker-compose.yml
imaging
imaging.exe
imagingsetup (only in ≥ 1.2.11)
imagingsetup.exe (only in ≥ 1.2.11)
LICENSE
Folders:
etl
etl-automation
login
logs
neo4j
server
Docker installer ≥ 1.2.11
Linux: ./imagingsetup -i install
Windows: imagingsetup.exe -i install
Linux: ./imagingsetup -d [custom_path] -i install
Windows: imagingsetup.exe -d [custom_path] -i install
Docker installer ≤ 1.2.10
Linux: ./imaging -s start
Microsoft Windows: imaging.exe -s start
Step 4 - test access
http://localhost:8083