Adding nodes Print

  • adding nodes, cluster join, scaling out, join token, node roles, horizontal scaling, capacity
  • 0

Medusa Panel › Server › Add Server

Adding a node tells the master about another server and installs the engine on it over SSH. Once it is in, the master manages it like any other node and you can use it for transcoding, for delivery, or both.

Before you start you need a reachable Linux server with SSH, and the master’s MySQL database reachable from it — the install and sync step needs the database. See System requirements.

Add the server

Open Medusa Panel › Server › Add Server and fill in:

  • Name — a label for the node.
  • SSH Hostname / Port / Username / Password — how the master connects to install and manage the node.
  • HTTP / RTMP Port — the ports the engine serves on this node.
  • Public IP / Domain — where viewers reach this node.
  • Primary Interface — the network interface whose traffic is measured.
  • Usable Egress Capacity — the bandwidth this node may use (Mbps or Gbps); load balancing uses it to size the node.
  • HTTPS — off, Let’s Encrypt (HTTP or DNS authorisation), or a Custom PEM File (paste the SSL Cert and SSL Key).
  • CDN Service — whether this node serves CDN output.
  • Install After Saving — run the SSH install straight away.

The install workflow

When you save with Install After Saving on, the master connects over SSH and, with live progress, installs the engine to /opt/medusa-engine, provisions the node’s RPC identity, writes its configuration pointing at the master’s database, and starts it. When it finishes, the node shows up in Servers.

Put the node to work

A new node can run streams and adapters at once. To use it for delivery, make sure its CDN Service is on and the CDN is enabled in Settings — see Built-in CDN.

Use Transfer Configuration on a server to move its streams, profiles or adapters to another node without rebuilding them — handy when you rebalance or retire a box.
The SSH account is used to install and manage the node, so it needs the rights to do that. Use a dedicated account and keep its credentials safe.

Related


Was this answer helpful?

« Back