Upgrade PX-Central from versions 1.2.x to 2.2.1


You cannot directly upgrade from PX-Central version 1.2.x to 2.2.1. To upgrade PX-Central from versions 1.2.x to 2.2.1, you must:

  1. upgrade from one of the PX-Backup versions 1.2.x to 2.1.2
  2. then upgrade from version 2.1.2 to 2.2.1

Prerequisites

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

Upgrade

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

  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.1.2:

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

After upgrading from 1.2.x version to 2.1.2, upgrade to version 2.2.1 by following the steps in the Upgrade from 2.1.2 to 2.2.1 procedure.

Upgrade in air-gapped environment

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

  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.1.2:

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

Last edited: Friday, Jul 22, 2022