Skip to main content
Version: 3.2

Upgrade Portworx Backup Using Argo CD

Applicable to Classic mode only

This topic details how to upgrade Portworx Backup using Argo CD.

Prerequisites​

Before you upgrade Portworx Backup using Argo CD, ensure that:

  • Your cluster meets the Requirements for Upgrading Portworx Backup.

  • Portworx Backup is already deployed using Argo CD. For initial installation steps, see Install Portworx Backup using Argo CD.

  • Argo CD is running at the version qualified for the Portworx Backup release you are upgrading to. Portworx Backup qualifies a specific Argo CD version for each release; for Portworx Backup 3.2.x, the qualified version is v3.2.5. For the full list, see Portworx Backup Argo CD compatibility matrix.

  • You have generated the Portworx Backup spec and created the pxc-credentials secret. For more information, see Generate Portworx Backup Spec.

  • The installCRDs parameter is removed from your Argo CD application values (values-px-central.yaml). Starting with Portworx Backup 3.2.0, this parameter is removed because Portworx Backup installs the required CRDs as part of the upgrade. Remove it before you upgrade to Portworx Backup 3.2.0 or later. For more information, see The installCRDs parameter.

  • If your Portworx Enterprise clusters still use a license server that you installed with Portworx Backup 3.1.1 or earlier. Then you have to annotate the license server resources, so that Argo CD doesn't prune them during the upgrade:

    kubectl annotate -n <pxb-namespace> \
    deploy/pxcentral-license-server svc/pxcentral-license \
    secret/px-license-secret cm/pxcentral-ls-configmap \
    argocd.argoproj.io/sync-options=Prune=false \
    argocd.argoproj.io/compare-options=IgnoreExtraneous --overwrite

    Replace <pxb-namespace> with the namespace where Portworx Backup is deployed.

Upgrade Portworx Backup using Argo CD​

To upgrade Portworx Backup using Argo CD, follow these steps:

  1. Log in and access the Argo CD web console.

  2. Navigate to Applications > Portworx Backup application card > Details > MANIFEST > Edit.

  3. Set the isUpgrade parameter to true.

    Argo CD renders the pre-upgrade hook only when isUpgrade is true.

  4. Set the targetRevision parameter value to the required Portworx Backup version.

    note

    For air-gapped environments, ensure that you download, extract, and commit the required px-central-<pxb-version>.tgz package to the git branch specified in targetRevision parameter.

  5. Click Save.

  6. Click SYNC.

  7. Select the Prune option and start the sync.

    Argo CD web console upgrades Portworx Backup version to the required version. Argo CD also deletes the license server resources from Portworx Backup 3.1.1 or earlier, so that they aren't left OutOfSync. If you annotated the license server resources as described in Prerequisites, Argo CD keeps them.

What to do next​

On each application cluster that you back up, upgrade Stork to a version compatible with your upgraded Portworx Backup version.

In this topic: