PX-Backup

PX-Enterprise

Install PX-Backup


Prerequisites

  • Stork 2.4.0 or newer
  • PX-Enterprise 2.5.0 or newer
  • PX-Central. Refer to the Install PX-Central on-premises page for details.
  • If you’re using an external OIDC provider, you must use certificates signed by a trusted certificate authority.
NOTE: PX-Backup does not support the following Portworx features:

  • PX-Security
  • PX-Essentials

Save your cloud credentials in a Kubernetes secret (Optional)

As part of the installation process, the spec generator asks you to input your cloud credentials. If you don’t want to specify your cloud credentials in the spec generator, you can create a Kubernetes secret and point the spec generator to that Kubernetes secret:

Create a Kubnernetes secret, save the name and namespace in which it’s located for use in the installation steps. The contents of the secret you create depend on the cloud you’re using:

  • AWS:

    kubectl --kubeconfig=$KC create secret generic $CLOUD_SECRET_NAME --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY --namespace $PXCNAMESPACE
  • Azure:

    kubectl --kubeconfig=$KC create secret generic $CLOUD_SECRET_NAME --from-literal=AZURE_CLIENT_SECRET=$AZURE_CLIENT_SECRET --from-literal=AZURE_CLIENT_ID=$AZURE_CLIENT_ID --from-literal=AZURE_TENANT_ID=$AZURE_TENANT_ID --namespace $PXCNAMESPACE
  • vSphere:

    kubectl --kubeconfig=$KC create secret generic $CLOUD_SECRET_NAME --from-literal=VSPHERE_USER=$VSPHERE_USER --from-literal=VSPHERE_PASSWORD=$VSPHERE_PASSWORD --namespace $PXCNAMESPACE

Install

  1. To install PX-Backup, generate the install script through the PX-Backup using PX-Central spec generator. If you saved your cloud credentials as a Kubernetes secret ahead of time, enter the name and namespace of your secret.

  2. Once you’ve generated the script, paste it into the command line of the Kubernetes master node in which you want to install PX-Backup and run it. The following example installs PX-Central with PX-Backup enabled:

    bash <(curl -s https://raw.githubusercontent.com/portworx/px-central-onprem/<version>/install.sh) --px-store --px-backup --admin-password 'examplePassword' --oidc --pxcentral-namespace portworx --px-license-server --license-password 'examplePassword' --px-backup-organization backup --cluster-name px-central --admin-email admin@portworx.com --admin-user admin

Configure external OIDC endpoints

If you enabled an external OIDC during PX-Central with PX-Backup installation, you must you must manually configure the redirect URI in your OIDC provider.

Refer to the Set up login redirects section of the PX-Enterprise documentation for instructions.


Last edited: Wednesday, Jun 10, 2020