Step 1 - ensure deployment requirements are in place

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.

Step 2 - download and process the installation files

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:

Linux

Download the Docker Installer extension from CAST Extend using curl:

• ensure you enter an appropriate CAST Extend API key in <key>. See CAST Extend website or Download an extension using CAST Extend API for more information about this
• the command below will download the latest release of the Docker Installer as a ZIP file- if you need to install a different release, ensure you state the specific extension release number, for example https://extend.castsoftware.com/api/package/download/com.castsoftware.imaging.docker/1.1.0-funcrel

curl -O -J "https://extend.castsoftware.com/api/package/download/com.castsoftware.imaging.docker" -H "x-nuget-apikey: <key>" -H "accept: application/octet-stream"

Then unpack the ZIP that has been downloaded:

unzip com.castsoftware.imaging.docker.1.2.0-funcrel.zip

This location is where CAST Imaging will be run from and where the CAST Imaging data will be stored. A set of files and folders is produced when the extension is unzipped:

.env
docker-compose.yml
etl
etl-automation
imaging
imaging.exe
LICENSE
login
logs
neo4j
nginx
server
-login
-sourcecode

Microsoft Windows

Download the Docker Installer extension from CAST Extend and unzip it to a working folder anywhere on the server - this location is where CAST Imaging will be run from and where the CAST Imaging data will be stored. A set of files and folders is produced when the extension is unzipped:

.env
docker-compose.yml
etl
etl-automation
imaging
imaging.exe
LICENSE
login
logs
neo4j
nginx
server
-login
-sourcecode

These files and folders will be mounted by the CAST Imaging containers, therefore you must ensure that you add the parent folder path to the Resources > File Sharing tab in the Docker for Windows GUI. For example, if you unzipped them to D:\Imaging, then you need to add D:\Imaging to the File Sharing tab. Ensure that you click Apply and Restart so that the changes are taken into account:

Step 3 - initial start-up

Start CAST Imaging with the following command using terminal (Linux) or a CMD prompt (Microsoft Windows). This will pull the most recent "funcrel" release docker images of CAST Imaging and start them up:

Linux: ./imaging -s start
Microsoft Windows: imaging.exe -s start

Step 4 - 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 8083. Ensure you specify the correct server (change "localhost"):

http://localhost:8083

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

Next steps?

You now need to configure CAST Imaging for use. Please action the following: