Upgrading the Hyperscale Compliance Engine (Docker Compose)

Pre-requisite

Before upgrading, ensure you have downloaded the Hyperscale Compliance 10.0.0 tar bundle from the Delphix Download website.

How to upgrade the Hyperscale Compliance Engine

Perform the following steps to upgrade the Hyperscale Compliance Engine to the 10.0.0 version:

1. Run cd /<hyperscale_installation_path>/ and docker-compose down to stop and remove all the running containers.

2. Run docker rmi -f $(docker images -q)to delete all the existing images.

3. Remove all files or folders from existing installation directories, except docker-compose.yaml.

4. Untar the patch tar in your existing installation path. tar -xzvf delphix-hyperscale-masking-10.0.0.tar.gz -C <existing_installation_path>

5. Change the existing docker-compose.yaml file as per the following:

   • For users upgrading from 3.0.0.x:

     • Take backup of existing docker-compose.yaml outside the installation directory so it is not overridden while executing the next step.

     • Rename the docker-compose-sample.yaml file supplied with the bundle to docker-compose.yaml and let's call it new docker-compose.yaml file.

     • Edit this new docker-compose.yaml and add the same 'volumes' and/or any other properties (if configured) for each container referencing the backed up docker-compose.yaml from the previous step.

   • For users upgrading from 4.0.0.0 and above: Use the existing (pre-upgrade) docker-compose.yaml file. But refer to the docker-compose-sample.yaml supplied with the bundle for any newly introduced configurations. If present, copy paste those configurations from docker-compose-sample.yaml to the exsiting docker-compose.yaml.

6. In the .env file supplied with the bundle, set the VERSION property as 10.0.0 (i.e. VERSION=10.0.0). For MSSQL deployments, change property LOAD_SERVICE_CANCELLABLE to false.

7. Run the below commands to load the images(will configure Oracle-based unload/load setup):

   CODE

   docker load --input unload-service.tar
   docker load --input masking-service.tar
   docker load --input controller-service.tar
   docker load --input load-service.tar
   docker load --input proxy.tar

   • If upgrading from an MSSQL connector setup(supported starting 5.0.0.0 release), instead of running the above commands for load/unload services setup(which are for Oracle), run the below commands(rest remains same for the controller, masking, and proxy services):

     CODE

     docker load --input mssql-unload-service.tar
     docker load --input mssql-load-service.tar

8. Run docker-compose up -d to create containers.

9. Ensure all your mount(s) are configured and accessible, before running a job.

Existing data remains intact after the degradation.