Install PX-Backup on air-gapped environment


This topic explains how you can prepare your clusters in an air-gapped environment and install PX-Backup on-premises.

Prepare air-gapped environments

If your cluster is internet-connected, skip this section. If your cluster is air-gapped, you must pull the following Docker images to either your docker registry, or your server:

  • docker.io/portworx/pxcentral-onprem-api:2.2.0
  • docker.io/portworx/pxcentral-onprem-ui-frontend:2.2.0
  • docker.io/portworx/pxcentral-onprem-ui-backend:2.2.0
  • docker.io/portworx/pxcentral-onprem-ui-lhbackend:2.2.0
  • docker.io/portworx/pxcentral-onprem-post-setup:2.2.0
  • docker.io/portworx/postgresql:11.13.0-debian-10-r19
  • docker.io/portworx/keycloak:14.0.0-v2
  • docker.io/portworx/keycloak-login-theme:2.0.1
  • docker.io/portworx/busybox:1.31
  • docker.io/portworx/mysql:5.7.37
  • docker.io/portworx/px-backup:2.2.0
  • docker.io/portworx/mongodb:4.4.4-debian-10-r30
  • portworx/kopiaexecutor:1.2.0
Note: Refer to the Prepare air-gapped environment section to know more about the Stork and other openstorage images in your air-gapped environment, before installing PX-Backup.

To pull the above Docker images and push them to an internal registry:

  1. Download the pxcentral-ag-install-backup.sh air-gapped bootstrap PX-Backup install script.

    curl -o pxcentral-ag-install-backup.sh -L "https://install.portworx.com/pxcentral-air-gapped?px-backup=true"

    You can also download the install script for a specific release by specifying a version query. For example:

    curl -o pxcentral-ag-install-backup.sh -L "https://install.portworx.com/pxcentral-air-gapped?version=2.2.0&px-backup=true"
  2. Pull the container images using the pxcentral-ag-install-backup.sh script.

    ./pxcentral-ag-install-backup.sh pull
  3. Push the images to a local registry server, accessible by the air-gapped nodes. Replace <repo> with your registry location.

    ./pxcentral-ag-install-backup.sh push <repo>
  4. Generate the px-backup installation spec (Helm command) from https://central.portworx.com/specGen/wizard. Select the Use custom registry button and provide the values for registry, repository, and image pull secret ( create a secret only if image pulling from an internal repository requires credentials).

  5. From the machine where the you run the helm3 command:

    • Download the latest px-central package with the following command.

      curl -O https://raw.githubusercontent.com/portworx/helm/master/stable/px-central-2.2.0.tgz
    • Modify the Helm command generated from Step 2 to provide the helm package, instead of providing the repository. For example:

      helm install px-central portworx/px-central --namespace central --create-namespace --version 2.2.0 -f values-px-central.yaml

      Following is the modified command for air gapped environment using the downloaded helm package:

      helm install px-central px-central-2.2.0.tgz --namespace central--create-namespace --version 2.2.0 -f values-px-central.yaml

After performing the above steps, refer to the Install PX-Backup section to install PX-Backup on-premises.


Last edited: Thursday, May 19, 2022