How to externally upgrade your Air-gapped Edge site

If you have an Air-gapped Edge site, you can download a new Zarf package to upgrade your site. You can also review the Software Bill of Materials, (SBOM) which outlines what is included in the upgrade, before upgrading your Edge sites. For more information about ZARF SBOMs, go to the ZARF SBOMs documentation.

Steps

  1. From the Downloads page, click the latest Collibra Zarf package.
    Note If you do not see Collibra CPSH extended capabilities please reach out to your Collibra account team.
  2. From the Collibra Zarf package page, click and download the Edge Zarf package.
  3. Set up your kubeconfig or kubecontext so that it points to the same Kubernetes cluster as your existing Air-gapped Edge site.
  4. If you don't plan to install Technical lineage Collibra Platform Self-Hosted, apply these priority classes with kubectl apply -f cpsh-priority-classes.yaml and /cpsh-platform-zarf-package/resources/cpsh-priority-classes.yaml:
    Copy
    apiVersion: scheduling.k8s.io/v1
    kind: PriorityClass
    metadata:
      name: platform
    value: 10000000
    description: "Platform supporting services level"
    ---
    apiVersion: scheduling.k8s.io/v1
    kind: PriorityClass
    metadata:
      name: application
    value: 100000
    description: "Application level"
    ---
    apiVersion: scheduling.k8s.io/v1
    kind: PriorityClass
    metadata:
      name: job
    value: 1000
    description: "Job level"
  5. Using the Zarf CLI:
    1. Copy and paste the following command in the Zarf CLI:
      Copy
      zarf package deploy <PATH TO ZST PACKAGE> \
          --set PLATFORM_ID=<DGC URL> \
          --set PLATFORM_USER=<DGC ADMIN NAME> \
          --set PLATFORM_PASSWORD=<DGC ADMIN PASSWORD> \
          --set SITE_NAME=<SITE_NAME> \
          --set EDGE_BACKUP_FILE=<EDGE_BACKUP_FILE>
    2. Enter the relevant details for each installation flag. For example, enter your Collibra Platform Self-Hosted URL for <DGC URL>.
      FlagDescription
      zarf package deploy <PATH TO ZST PACKAGE>The path Edge site Zarf package you downloaded.
      --set PLATFORM_ID=<DGC URL>The URL of your Collibra Platform Self-Hosted.
      --set PLATFORM_USER=<DGC ADMIN NAME> The username of your Collibra admin.
      --set PLATFORM_PASSWORD=<DGC ADMIN PASSWORD>The password of your Collibra admin.
      --set SITE_NAME=<SITE_NAME>

      The name of your existing Edge site.

      Warning The site name must exactly match the existing Edge site you want to upgrade. If it doesn't match, a second Edge site is created without your connections or capabilities, and your original Edge site is unhealthy.
      --set EDGE_BACKUP_FILE=<EDGE_BACKUP_FILE>If you have stored the Edge site backup file somewhere other than the default location, specify the file path to your Edge site backup.
    3. Run command to upgrade the Edge site.
      Your Air-gapped Edge site is created and deployed.
      Note  If an Air-gapped Edge site fails to install on your Kubernetes cluster, a site is still created in Edge. You can choose to do one of the following:
      • Remove the failed Edge site from your Kubernetes cluster and Edge by running the following command:
        Copy
        zarf package remove ZARF_PACKAGE_FILE/ZARF_PACKAGE_NAME
      • Remove the failed Edge site from your Kubernetes cluster, but keep the Edge site in Edge by running the following command:
        Copy
         ZARF_VAR_KEEP_CPSH_EDGE_SITE=true \
             zarf package remove ZARF_PACKAGE_FILEZARF_PACKAGE_NAME
        When you try to install or reinstall the failed Air-gapped Edge site installation, you can use the same name to reuse the Edge site in Edge.
  6. Log in to Edge to add connections and capabilities to your Air-gapped Edge site.

What's next?