Upgrade

Learn how to upgrade Pachyderm to access new features and performance enhancements.

Before You Start #

2.10.0 Requirements

If you are upgrading to (2.10.0+), you must:

• Provide a storageURL in your Helm chart values at pachd.storage.storageURL to enable blob/object storage.

• Check the release notes before upgrading
• Back up your cluster
• Update your Helm chart values if applicable

How to Upgrade #

Run a Preflight Check #

PachD has a preflight check mode that you can enable in your Helm chart by setting pachd.preflightchecks.enabled to true. Preflight checks run as a Kubernetes job, and can use a different version of Pachyderm than the rest of the chart. In this case, you will set it to the version you are upgrading to (for example, the latest version is 2.10.0).

Example configuration:

preflightCheckJob:
    enabled: true
    image:
        tag: "2.10.0"

You’ll see a pod named pachyderm-preflight-check was created to perform the preflight checks.

• If its status says completed, you are ready to continue with the upgrade.
• If its status does not say completed, reach out to the Pachyderm team for assistance with your upgrade.

kubectl get pods
NAME                                         READY   STATUS      RESTARTS   AGE
console-76f5fd8c58-zwvj5                     1/1     Running     0          13m
default-edges-v1-bl6cf                       2/2     Running     0          12m
default-montage-v1-tbj6p                     2/2     Running     0          12m
etcd-0                                       1/1     Running     0          13m
minio-0                                      1/1     Running     0          14m
pachd-6c99fc7448-vsjbn                       1/1     Running     0          13m
pachyderm-kube-event-tail-5957785f5d-4557j   1/1     Running     0          13m
pachyderm-loki-0                             1/1     Running     0          13m
pachyderm-preflight-check-rh9rp              0/1     Completed   0          13m
pachyderm-promtail-h29zv                     1/1     Running     0          13m
pachyderm-proxy-7956c766bd-drndd             1/1     Running     0          13m
pg-bouncer-686db6477c-rjwgl                  1/1     Running     0          13m
postgres-0                                   1/1     Running     0          13m

Upgrade #

1. Run the following brew command or download & install the latest release assets:

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

   Copy

2. Upgrade Helm.

   Production Local (Personal Machine)

   Note that the repo name input (pachd) must match the name you provided upon first install. You can also pass in a specific version (e.g., --version x.x.0-rc.1) if you are testing a pre-released version of Pachyderm.

   helm repo update
   helm upgrade pachyderm pachyderm/pachyderm -f my_pachyderm_values.yaml  \
   --set proxy.enabled=true \
   --set proxy.service.type=LoadBalancer 

   Copy

   Note that the repo name input (pachd) must match the name you provided upon first install. You can also pass in a specific version (e.g., --version x.x.0-rc.1) if you are testing a pre-released version of Pachyderm.

   helm repo update
   helm upgrade pachyderm pachyderm/pachyderm \
   --set deployTarget=LOCAL \
   --set proxy.enabled=true \
   --set proxy.service.type=LoadBalancer \
   --set pachd.storage.backend=AMAZON 

   Copy

3. Verify that the installation was successful by running pachctl version:

   pachctl version 
   
   # COMPONENT           VERSION  
   # pachctl             2.10.0 
   # pachd               2.10.0 

   Copy