Manager Installation

Overview

This guide outlines the requirements and steps to deploy Observo Manager in your environment. Observo Manager is the management platform that enables configuration of one or more Observo Sites in your environment.

Prerequisites

• Kubernetes Cluster: A deployed Kubernetes cluster to host Observo Manager and kubectl to access the cluster.

• Helm: Helm must be installed (avoid version 3.13.0 due to OCI chart issues)

• Container Images: Access to Observo Manager container images in your registry

• Ingress Controller: Required for communication between Observo Manager and Sites

Resource Requirements

These requirements are specific to Observo Manager. For running Observo Site in the same cluster, contact the Observo team for recommendations.

Kubernetes Requirements

1. 3-node Kubernetes cluster

2. Node specifications:

   • 4 vCPU

   • 16 GB Memory

   • 15GB Disk Volume

3. Additional storage:

   • 50GB Kubernetes storage (CSI driver)

4. Required cluster add-ons:

   • CNI driver

   • CSI driver

   • kube-proxy

   • core-dns

Pre-Installation Steps

1. Create Namespace

kubectl create namespace observo

2. Prepare Images

tar -xvzf airgapped_images.tar.gz
cd airgapped_images

Work with the Observo team to upload images to your container registry.

3. Configure Database

Create PostgreSQL credentials secret if you want use existing database:

kubectl create secret generic postgres-auth \
    --from-literal=host=<db-host> \
    --from-literal=port=<db-port> \
    --from-literal=username=<db-user> \
    --from-literal=password=<db-password> \
    --from-literal=db_name=<db-name> \
    -n observo

Installation Steps

1. Configure Values File

Update your values.yaml with required settings:

global:
    imageRegistry: "<your-registry>"
    observoImageRegistry: "<your-registry>"
    version: "<version>"
    dbCred:
        secretName: "postgres-auth"
        create: false

2. Deploy Manager

helm upgrade --install observo-manager ./observo-manager-<version>.tgz \
    --namespace observo \
    --values values.yaml

3. Verify Deployment

kubectl get pods -n observo
kubectl get svc -n observo

Post-Installation

1. Access Observo UI

kubectl port-forward svc/observo-proxy -n observo 9000:9000

Access via browser: 127.0.0.1:9000

For accessing Observo UI from your hostname, configure the cluster with ingress and add observo-proxy k8s service.

2. Initial Configuration

• Add users in Observo

• Configure SSO

Next Steps

1. Install Observo Site

2. Set up monitoring and alerts

For detailed configuration options, refer to the Helm Values Reference.