Installation Guide

Installing the CDN Manager with the deploy command

You're viewing a development version of manager, the latest released version is 1.6.2

Overview

The CDN Manager is installed with deploy, a command on the installation ISO. You describe your machines and your site in a few files on the first machine, and deploy does the rest over SSH: it configures each machine’s firewall and network, builds the Kubernetes (k3s) cluster, installs the CDN Manager, and checks that it is healthy.

deploy is the only supported way to install the CDN Manager. Running the ISO’s install, join-server and join-agent scripts by hand is no longer supported.

New here? Start with the Quickstart. It walks you through a complete installation on three machines, from minimal operating system installs to signing in to the GUI. The other pages cover the details and the variations.

Upgrading from 1.6 or earlier? Version 1.8 cannot be installed over an earlier release. Install it on a new cluster. See the Upgrade Guide.

How It Works

flowchart LR
    A[Mount the ISO<br>on the first server] --> B[deploy init]
    B --> C[Edit /etc/acd/deploy]
    C --> D[deploy]
    D --> E[Sign in to the GUI]

Mount the ISO on the machine that will be the first server.
Run deploy init once. It installs Ansible and creates the configuration folder /etc/acd/deploy.
Edit the configuration: the machines and their roles, your site settings, and optionally a TLS certificate, MaxMind databases and application settings.
Run deploy. It checks everything first, takes a backup, then installs or updates the cluster to match your configuration.

To change anything later, edit the configuration and run deploy again. Every run is safe to repeat.

Guides

Guide	What it covers
Quickstart	A complete installation, start to finish
Inventory	Listing your machines and their roles, and per-machine options
Site Settings	Every setting in `group_vars/all.yaml`
TLS Certificates	Serving HTTPS with your own certificate
MaxMind GeoIP Databases	Enabling geographic routing
Application Settings	Presets and `values.override.yaml`
Running deploy	What a run does, checking and restoring backups, and what to send support
Changing the Cluster	Adding machines and changing a machine’s role
Air-Gapped Installation	Installing without internet access
Upgrade Guide	Moving to a new release
Installation Troubleshooting	What each failure code means and what to do
Next Steps	Securing the administrator account and adding users

Prerequisites

Machines meeting the System Requirements: three servers for production, optionally with agents for extra capacity. A single server is enough for a lab.
Operating system: a minimal install of Red Hat Enterprise Linux 9.4 or later, or a compatible rebuild, with firewalld and NetworkManager running.
Network: a default route on every machine and, optional but recommended, a backplane network, separate from the public network, that all the machines are reachable on. See the Networking Guide.
Access: passwordless root SSH from the first server to every machine, itself included.
Software: the installation ISO from the AgileTV customer portal, and dnf access to the operating system’s repositories on every machine.
Recommended: a TLS certificate from a trusted certificate authority, and MaxMind GeoIP databases from your own MaxMind subscription.

Getting Help

Installation Troubleshooting lists every failure code deploy reports.
If the final health check fails, deploy writes /etc/acd/deploy/support-bundle-acd.tar.gz. Send it to AgileTV support.
The Release Notes list known issues for each version.