Upgrade PX-Central from versions 1.2.x to 2.0.x


The PX-Central 1.2.x versions include the following three Helm charts to upgrade the PX-Backup, License Server, Monitoring service components, independently:

  • px-backup
  • px-monitor
  • px-license-sever

The PX-Central 2.0.x versions include only the px-central chart, using which you can upgrade all three PX-Central components.

Prerequisites

Ensure a PX-Central version 1.2.x is installed.

Upgrade

To upgrade the PX-Central versions 1.2.x to 2.0.x:

  1. Download the migration.sh file.

    curl https://raw.githubusercontent.com/portworx/helm/master/single_chart_migration/migration.sh -o migration.sh
  2. Change the migration.sh file permissions to make it executable.

    chmod +x migration.sh
  3. Update the Helm repository.

    helm repo update
  4. Search for the Portworx repository.

    helm search repo portworx
  5. Get the namespace where the PX-Central components are installed.

    helm ls -A | grep "px-backup-[0-9].[0-9].[0-9]" | awk '{print $2}'
  6. Run the migration.sh file to upgrade to PX-Central 2.0.x.

    ./migration.sh --namespace <namespace> --helmrepo <helm repo name> --admin-password <current-admin-user-password>

If you are in air-gapped environment, then follow the steps below to upgrade PX-Central from the prior versions to 2.0.x:

  1. Clone the Portworx helm repository.

    git clone https://github.com/portworx/helm.git
  2. Make the migration.sh an executable file.

    chmod +x /single_chart_migration/migration.sh
  3. Get the namespace where the PX-Central components are installed.

    helm ls -A | grep "px-backup-[0-9].[0-9].[0-9]" | awk '{print $2}'
  4. Modify the px-central/values.yaml file matching your internal registry, repository, and image pull secret parameters. Pass the modified values.yaml file with the --helm-values-file option.

  5. Run the migration.sh file to upgrade to PX-Central 2.0.x.

    ./migration.sh --namespace <namespace> --helmrepo <current-directory/charts> --admin-password <current-admin-user- password> --air-gapped --helm-values-file <values.yaml>

Last edited: Tuesday, Aug 31, 2021