Upgrade Deployment

Upgrading your OpenReplay deployment to the latest version requires updating both your backend (instance) and tracker.

Note: If your OpenReplay version is prior to v1.4.0 then read this first before continuing with the below instructions.

1. Copy/backup the current openreplay folder to _version-number like below:

mv openreplay openreplay_v1.4.0

2. Clone the new OpenReplay version. In this example we’re upgrading to the latest available version:

git clone https://github.com/openreplay/openreplay

3. Upgrade OpenReplay:

cd openreplay/scripts/helmcharts

# Merge previous vars.yaml with current var.yaml (using yq for yaml parsing)
cp ~/openreplay_v1.4.0/scripts/helmcharts/vars.yaml old_vars.yaml
wget https://github.com/mikefarah/yq/releases/download/v4.24.4/yq_linux_amd64 -O yq
chmod +x ./yq
./yq '. *= load("old_vars.yaml")' vars.yaml > new_vars.yaml
mv new_vars.yaml vars.yaml

# Cleanup depricated resource
kubectl delete ing -n db minio-frontend

# Setting proper permisson
/bin/bash -c '[[ -d /openreplay ]] && sudo chown -R 1001:1001 /openreplay'

# Upgrade openreplay
helm upgrade --install openreplay ./openreplay -n app --wait -f ./vars.yaml --atomic

4. If you’re not using a load balancer and have generated your SSL certificate via the certmanager.sh script:

cd openreplay/scripts/helmcharts && bash certmanager.sh

5. Update fromVersion variable in /openreplay/scripts/helmcharts/vars.yaml to reflect the new version. As an example if you’re moving from v1.4.0 to v1.8.0 then update the fromVersion like below:

fromVersion: "v1.8.0"

Ensure your tracker (and tracker-assist plugin if you do use the Assist plugin) is compatible with the new backend version by checking the above compatibility table.

If you encounter any issue during the upgrade process, reach out on Slack or check out our Forum and get help from our community.