Upgrade Portworx Central from versions 1.2.1 to 2.8.1

Portworx Central on-premises supports upgrades to version n from versions n-1 or n-2 versions. For example, if you are on Portworx Central version 2.6.1, you can directly upgrade to 2.8.1. Suppose, if you are on 2.4.1 and you wish to upgrade to 2.8.1, you need to upgrade in phased manner. Firstly upgrade from version 2.4.1 to 2.6.1, and then upgrade from version 2.6.1 to 2.8.1.

You cannot directly upgrade from Portworx Central version 1.2.1 to 2.8.1. To upgrade Portworx Central from versions 1.2.1 to 2.8.1, you must:

1. Upgrade from one of the Portworx Central versions 1.2.1 to 2.6.1
2. Then upgrade from version 2.6.1 to 2.8.1

Prerequisites

Ensure a Portworx Central version 1.2.1 is installed.

Upgrade

To upgrade the Portworx Central versions 1.2.1 to 2.6.1:

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

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

After upgrading from 1.2.1 version to 2.6.1, upgrade to version 2.8.1 by following the steps in the Upgrade from 2.6.1 to 2.8.1 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.8.1:

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

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