Upgrading

This guide provides instructions for upgrading your Observo Site installation to a newer version.

Prerequisites

Before starting the upgrade process, ensure you have:

• Current version details

• Access to the new version artifacts

• Backup of current configuration

Check Current Version

Get your current Observo Site version:

kubectl get deployment -n observo-client control-agent -ojson |  jq -r '.spec.template.spec.containers[0].env[] | select(.name == "SERVICE_VERSION") | .value'

Preparation Steps

1. Backup Configuration

Get current Helm values:

helm get values -n observo-client observo-site > site-values-backup.yaml

2. Download New Configuration

1. Access Observo Settings page

2. Navigate to Site section

3. Download the latest Helm configuration

3. Update Configuration File

Important values to update:

• Image token

• Any custom configurations from previous deployment

Upgrade Procedure

1. Verify Prerequisites

# Check cluster status
kubectl get nodes
kubectl get pods -n observo-client

2. Deploy Upgrade

helm upgrade --install -n observo-client observo-site \
    oci://public.ecr.aws/e4z0a1h1/observo-site \
    --create-namespace \
    --set global.version="<new-version>" \
    --values=<helm-config-file>.yaml

Replace:

• <new-version> with the target version

• <helm-config-file> with your configuration file path

3. Monitor Upgrade Progress

# Watch pods
kubectl get pods -n observo-client -w

# Check rollout status
kubectl rollout status deployment/control-agent -n observo-client
kubectl rollout status deployment/data-plane -n observo-client

Post-Upgrade Verification

1. Check Component Status

# Verify all pods are running
kubectl get pods -n observo-client

# Check services
kubectl get svc -n observo-client

# Verify deployments
kubectl get deployments -n observo-client

2. Validate Functionality

• Verify Site status in Observo UI

• Check data ingestion

• Test existing pipelines

Rollback Procedure

If issues occur during upgrade, follow these steps to rollback:

1. Initiate Rollback

# Get previous release revision
helm history -n observo-client observo-site

# Rollback to previous version
helm rollback -n observo-client observo-site <revision-number>

2. Verify Rollback

# Check pod status
kubectl get pods -n observo-client

# Verify version
kubectl get deployment -n observo-client control-agent -ojson | \
    jq -r '.spec.template.spec.containers[0].env[] | select(.name == "SERVICE_VERSION") | .value'

For additional assistance or configuration details, refer to:

• Installation Guide

• Helm Values Reference