Upgrade Pachyderm¶

Upgrades between minor releases or patch releases, such as 2.1.0 to version 2.2.0, should be seamless. Therefore, the upgrade procedure is simple and requires little to no downtime. As a good practice, we recommend that you check the release notes before an upgrade to get an understanding of the changes introduced between your current version and your target.

Warning

Do not use these steps to upgrade between major versions as it might result in data corruption.

Complete the following steps to upgrade Pachyderm from one minor release to another.

1- Backup Your Cluster¶

As a general good practice, start with the backup of your cluster as described in the Backup and Restore section of this documentation.

2- Update Your Helm Values¶

This phase depends on whether you need to modify your existing configuration (for example, enter an enterprise key, plug an identity provider, reference an enterprise server, etc...).

In the case of a simple upgrade of version on a cluster, and provided that you do not need to change any additional configuration, no change in the values.yaml should be required. The new version of Pachyderm will be directly set in the helm upgrade command.

3- Upgrade `pachctl` Version¶

To update to the latest version of Pachyderm, run the steps below depending on your operating system:

For macOS, run:

brew tap pachyderm/tap && brew install pachyderm/tap/pachctl@2.3

For a Debian-based Linux 64-bit or Windows 10 or later running on
WSL:

curl -o /tmp/pachctl.deb -L https://github.com/pachyderm/pachyderm/releases/download/v2.3.5/pachctl_2.3.5_amd64.deb && sudo dpkg -i /tmp/pachctl.deb

For all other Linux flavors:

curl -o /tmp/pachctl.tar.gz -L https://github.com/pachyderm/pachyderm/releases/download/v2.3.5/pachctl_2.3.5_linux_amd64.tar.gz && tar -xvf /tmp/pachctl.tar.gz -C /tmp && sudo cp /tmp/pachctl_2.3.5_linux_amd64/pachctl /usr/local/bin

Note

For a specific target release, specify the targeted major/minor version of pachctl for brew and major/minor/patch release for curl in the commands above.

Verify that the installation was successful by running pachctl version --client-only:

pachctl version --client-only

System Response:

COMPONENT           VERSION  
pachctl             <This should display the version you installed>

4- Helm Upgrade¶

Redeploy Pachyderm by running the helm upgrade command with your updated values.yaml:

helm repo add pach https://helm.pachyderm.com
helm repo update
helm upgrade pachd -f my_pachyderm_values.yaml pach/pachyderm --version <your_chart_version>

Note

Each chart version is associated with a given version of Pachyderm. You will find the list of all available chart versions and their associated version of Pachyderm on Artifacthub.

The upgrade can take some time. You can run kubectl get pods periodically in a separate tab to check the status of the deployment. When Pachyderm is deployed, the command shows all pods as READY:
```
kubectl get pods
```
Once the pods are up, you should see a pod for pachd running (alongside etcd, pg-bouncer, postgres, console etc... depending on your installation).

System response:
```
NAME                     READY     STATUS    RESTARTS   AGE
pachd-3677268306-9sqm0   1/1       Running   0          4m
...
```

Verify that the new version has been deployed:

pachctl version

System response:

COMPONENT           VERSION
pachctl             2.3.5
pachd               2.3.5

The pachd and pachctl versions must both match the new version.

Last update: July 23, 2022

Does this page need fixing?