Upgrading the Hyperscale Compliance Orchestrator (Kubernetes)

Beginning with version 2025.8.0, the Hyperscale database has migrated from SQLite to PostgreSQL, and all existing customer data is migrated as part of this change.
If you are upgrading to this version, monitor the Migration Status API to ensure the migration completes successfully. The migration is complete only when the response status is SUCCEEDED. If the API reports an error, generate a support bundle and submit it to Perforce Customer Support for assistance.

Limitation

This release does not support using an external PostgreSQL instance as the Hyperscale database.

Procedure

Perform the following steps to upgrade a Hyperscale Compliance Orchestrator (Kubernetes).

Create a new folder called hyperscale-helm-[version], where [version] is the latest version to which the platform is being upgraded.

$ mkdir hyperscale-helm-[version]
Download the new version of the chart using the following command in tandem with the newly created folder. Note: This command will download a file named hyperscale-helm-[version].tgz in the folder hyperscale-helm-[version].
```
$ cd hyperscale-helm-[version]
$ curl -XGET https://dlpx-helm-hyperscale.s3.amazonaws.com/hyperscale-helm-[version].tgz -o hyperscale-helm-[version].tgz
```
The downloaded file is then extracted using the following command.

$ tar -xvf hyperscale-helm-[version].tgz

This will extract into the following directory structure.

Copy

hyperscale-helm
    ├── Chart.yaml
    ├── README.md
    ├── templates
        │-<all templates files>
    ├── tools
        │-<all tool files>
    ├── values-file-connector.yaml
    ├── values-mongo.yaml
    ├── values-mssql.yaml
    ├── values-oracle.yaml
    ├── values-parquet.yaml
    ├── values-snowflake.yaml
    └── values.yaml

Configure the values.yaml and values-<connector>.yaml files from the new Helm chart by referring to the properties defined in the corresponding files from the previous version.
After copying the values.yaml and values-<connector>.yaml files, there are updates that need to be made to the file under the imageCredentials section:
- If the credentials configured in your values.yaml have expired, which will be the case if the credentials were unused for 30 days or were inactive (but previously used) for 90 days, please retrieve a new set of credentials by visiting the HyperscaleCompliance page on http://download.delphix.com and selecting the HyperscaleHelm Repository link. Configure your values.yaml with the new set of credentials.
  - This password update in values.yaml is only required if the user is using a Delphix-provided Docker Registry (hyperscale.download.delphix.com/delphix-hyperscale) directly in the deployment (i.e. values.yaml).
  - If you are using your internal Docker Registry, you should first pull the next version of the Docker images from the Delphix-provided registry with the credentials associated with your Delphix account.
  - The following are the ‘docker’ commands that can be used to pull Docker images into your internal Docker Registry:
    - Docker login command (username and password are your permanent credentials retrieved from Delphix Download site.
      Copy
      $ docker login --username [USER] --password [PASSWORD]
    - Pull Docker images of the Hyperscale Compliance services.
      Copy
      $ docker pull <image-url>
The image URLs for the Hyperscale Compliance services can be referenced from this page of the documentation.
Provide the values for NFS/AWS S3 related parameters to setup the mount-filesystem.

Upon application startup, all existing mount-filsystems will be deleted. Please ensure to take backup of the mount setup details, if needed.

If upgrading from a version <= 23.0.0 and the staging area volume has been configured via NFS storage, ensure that all of the following parameters have been set in the values.yaml file of the latest version's helm chart bundle:

nfsStorageHost - Set this to the same value as set in the previous version's helm chart values.
nfsStorageExportPath - Set this to the same value as set in the previous version's helm chart values.
nfsStorageMountType - Set this to one of applicable values(NFS4, NFS3, CIFS).

Run the helm upgrade command.

Copy

$ helm upgrade -f values-<connector>.yaml hyperscale-helm hyperscale-helm