Live Monitoring Setup Guide

This guide will walk you through the complete setup and basic operation of the Simons Observatory live housekeeping monitor. By the end of this guide you will be able to command your hardware systems using OCS, record their data to disk in the so3g file format, and monitor their output in real time using a Grafana dashboard.

Contents:

• Dependencies
  • Software Requirements
  • Hardware Requirements
  • Networking Requirements
• Software Installation
  • Installing Docker
  • Installing Docker Compose
  • Installing OCS
• Environment Setup
  • Setup Scripts
    • TLS Certificate Generation
    • Docker Environment Setup
  • Manual Setup Steps
    • OCS User/Group and Data Directory Creation
    • OCS Config Setup
    • Login to Docker Registry
• Configuration
  • docker-compose.yaml
  • OCS
• Running Docker
  • Using Docker
    • Viewing Logs
    • Updating Containers
    • Restarting Containers
    • Shutting Down All Containers
• Running OCS Clients
• Using Grafana
  • Set a Password
  • Configuring the Data Source
  • Configuring a Dashboard
  • Viewing the Live Monitor
• Other Info
  • Grafana
    • Backing up Panels
  • Networking
    • Configuring a Firewall
    • Port Forwarding to View Remotely