Installation Guide

Step-by-step installation and upgrade procedures
You're viewing a development version of manager, the latest released version is v1.4.1
Go to the latest released version

Overview

This guide provides detailed instructions for installing the AgileTV CDN Manager (ESB3027) in various deployment scenarios. The installation process varies depending on the target environment and desired configuration.

Estimated Installation Time:

Deployment TypeTime
Single-Node (Lab)~15 minutes
Multi-Node (3 servers)~30 minutes

Actual installation time may vary depending on hardware performance, network speed, and whether air-gapped procedures are required.

Note: These estimates assume the operating system is already installed on all nodes. OS installation is outside the scope of this guide.

Installation Types

Installation TypeDescriptionUse Case
Single-Node (Lab)Minimal installation on a single hostAcceptance testing, demonstrations, development
Multi-Node (Production)Full high-availability cluster with 3+ server nodesProduction deployments

Installation Process Summary

The installation follows a sequential process:

  1. Prepare the host system - Verify requirements and mount the installation ISO
  2. Install the Kubernetes cluster - Deploy K3s, Longhorn storage, and PostgreSQL
  3. Join additional nodes (production only) - Expand the cluster for HA or capacity
  4. Deploy the Manager application - Install the CDN Manager Helm chart
  5. Post-installation configuration - Configure authentication, networking, and users
GuideDescription
Installation ChecklistStep-by-step checklist to track progress
Single-Node InstallationLab and acceptance testing deployment
Multi-Node InstallationProduction high-availability deployment
Air-Gapped DeploymentAir-gapped environment installation
Upgrade GuideUpgrading from previous versions
Next StepsPost-installation configuration tasks

Prerequisites

Before beginning installation, ensure the following requirements are met:

  • Hardware: Nodes meeting the System Requirements including CPU, memory, and disk specifications
  • Operating System: RHEL 9 or compatible clone (details); air-gapped deployments require the OS ISO mounted on all nodes
  • Network: Proper firewall configuration between nodes (port requirements, firewall configuration)
  • Software: Installation ISO obtained from AgileTV; air-gapped deployments also require the Extras ISO
  • Kernel Tuning: For production deployments, apply recommended sysctl settings (Performance Tuning Guide)

We recommend using the Installation Checklist to track your progress through the installation process.

Getting Help

If you encounter issues during installation:


Installation Checklist

Step-by-step checklist to track installation progress

Single-Node Installation

Lab and acceptance testing deployment

Multi-Node Installation

Production high-availability deployment

Air-Gapped Deployment Guide

Installation procedures for air-gapped environments

Upgrade Guide

Upgrading the CDN Manager to a newer version

Next Steps

Post-installation configuration tasks