Imaging V3 - cloud

---

Overview

This guide provides instructions for running an in-place update to a new release of CAST Imaging i.e. using the Helm Chart scripts provided in com.castsoftware.castimaging-v3.kubernetessetup for Cloud services via Kubernetes:

• on one single machine
• or via a distributed deployment (multiple machines)

This process will update the following installed components and retain all existing data (applications, results, etc.):

• imaging-services
• imaging-viewer
• analysis-node
• dashboards

In addition, the guide covers the update of your existing applications to a new Core release (the analysis engine installed on each of your analysis-node instances).

Supported update paths

Source	Target	Supported?	Notes
3.3.0-funcrel / 3.3.1-funcrel	3.4.0-funcrel / 3.4.1-funcrel / 3.4.2-funcrel / 3.4.3-funcrel	:whitecheckmark:	See the instructions below.
3.3.0-funcrel	3.3.1-funcrel	:whitecheckmark:	See the instructions below.
3.2.2-funcrel / 3.2.3-funcrel	3.3.0-funcrel / 3.3.1-funcrel	:whitecheckmark:	See the instructions below.
3.2.2-funcrel	3.2.3-funcrel	:whitecheckmark:	See the instructions below.
3.1.0-funcrel	3.2.2-funcrel / 3.2.3-funcrel	:whitecheckmark:	See the instructions below.
3.0.0-funcrel	3.1.0-funcrel	:x:	Not supported - a fresh installation of the target release is required.

Requirements

• Local administrator privileges (user in the sudoers list / ability to Run as administrator)
• All existing containers should be left running during the update (the update script will stop and restart them automatically)
• Sufficient local disk space for the new images
• A previous CAST Imaging installation should exist on the target machines
• In a distributed deployment scenario all components MUST be updated to the same new release (i.e. you cannot update just the analysis-node component or just the imaging-services component)

Update process

Step 1 - Clone target release branch

Clone the target release Git repository branch (i.e. matching the release of CAST Imaging you want to update to) of com.castsoftware.castimaging-v3.kubernetessetup. For example to clone the 3.4.0-funcrel release branch use:

git clone -b 3.4.0 https://github.com/CAST-Extend/com.castsoftware.castimaging-v3.kubernetessetup

Step 2 - Update *.yaml files

Update the target release manifest files by re-applying any customization you made to the currently deployed ones, e.g.:

• values.yaml
• templates/console-authenticationservice-configmap.yaml
• ...

Step 3 - Run the update

Use the following script (located at the root of the cloned Git repository branch) to stop CAST Imaging services:

• Util-ScaleDownAll.bat or Util-ScaleDownAll.sh

Run the Helm upgrade script:

• helm-upgrade.bat or helm-upgrade.sh

Step 4 - Verify update success

• Verify services in the CAST Imaging admin panel:
  • Navigate to the Services settings page
  • Confirm all services show green status indicators:

Step 5 - Check Core release

{{< readfile "../includes/checkcorerelease.md" >}}

Step 6 - Update application to new Core release

{{< readfile "../includes/update_app.md" >}}

Done...

That's it you're done and your installation and applications are now up-to-date.