Skip to main content
Version: 2.5

Upgrade Portworx Central from versions 1.2.x to 2.6.0

You cannot directly upgrade from Portworx Central version 1.2.x to 2.6.0. To upgrade Portworx Central from versions 1.2.x to 2.6.0, you must:

  1. Upgrade from one of the Portworx Backup versions 1.2.x to 2.x.x
  2. Then upgrade from version 2.x.x to 2.6.0

Prerequisites

Ensure a Portworx Central version 1.2.x is installed.

Upgrade

To upgrade the Portworx Central versions 1.2.x to 2.x.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 Portworx 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 Portworx Central 2.x.x:

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

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

Upgrade in air-gapped environment

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

  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 Portworx 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 Portworx Central 2.6.0:

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