NICE re/streamer pro

Guides

Maître et esclaves : installation et configuration

Comment répartir les spectateurs sur plusieurs serveurs. Le serveur principal (maître) garde la base de données et décide où va chaque client. Les serveurs supplémentaires (esclaves) diffusent les chaînes à sa place.

Fonctionnement

  1. Le client se connecte au maître comme avant. Les adresses des playlists ne changent pas.
  2. Le maître choisit un serveur et y redirige le client. Les playlists (Xtream, M3U, Stalker, NICE, TVIP) contiennent directement l’adresse de l’esclave choisi.
  3. L’esclave vérifie l’abonné avec sa propre copie des données et lance le flux. Les films et séries (VOD) sont lus depuis le maître.
  4. Toutes les 15 secondes, l’esclave demande les changements au maître et ne télécharge que ce qui a changé, logos des chaînes compris. Avec une clé, il envoie aussi un rapport de charge.

Un esclave exécute le même programme que le maître. Seul un réglage diffère : Configuration → BALANCER.

Avant de commencer

1Faire du serveur le maître

Sur le serveur principal, ouvrez Configuration → onglet BALANCER.

Configuration → BALANCER sur le maître : type Master, clé, Generate, Save
  1. Balancer type → Master.
  2. Balancer key — le secret partagé entre le maître et ses esclaves. Tout ce qui circule entre eux, mots de passe des abonnés compris, est chiffré et signé avec cette clé.
  3. Generate crée une clé aléatoire. Vous pouvez aussi saisir la vôtre : 16 à 128 caractères, lettres, chiffres, - et _. Copiez la clé — chaque esclave en a besoin.
  4. Save.
Sans clé, cela fonctionne aussi, mais sans protection.

L’ancien protocole est alors utilisé : son chiffrement est identique pour toutes les installations et l’esclave n’est reconnu que par son IP. Le rapport de charge et la limite de connexions commune ne fonctionnent pas non plus. Nous recommandons de toujours définir une clé.

2Ajouter l’esclave sur le maître

Sur le maître : Channels → Balancers. Renseignez le nouveau serveur dans la ligne Add.

Le formulaire d’ajout : Id, nom, adresse, pays
  1. Id — le numéro de l’esclave. Un numéro libre est proposé. Notez-le : le même numéro se saisit sur l’esclave.
  2. Nom — par ex. DE-1. C’est par ce nom qu’on affecte un abonné à l’esclave.
  3. IP address or host name — l’adresse pour les clients : 203.0.113.21 ou de1.example.com. Les spectateurs y sont redirigés et elle figure dans les playlists.
  4. Pays et réseaux — qui l’esclave dessert : codes pays (DE,AT), sous-réseaux (10.20.0.0/16) ou IP isolées, séparés par des virgules. Laissez vide si l’esclave ne sert que des abonnés affectés manuellement.
  5. Panel language de l’esclave — anglais ou bulgare.
  6. Stream workers — auto (recommandé) ou un nombre fixe. Voir « Réglages de l’esclave depuis le maître » plus bas.
  7. Source read, ms — 20 par défaut.
  8. Add balancer.
Astuce

Si vous installez par SSH (option A à l’étape suivante), vous pouvez sauter cette ligne : l’installation ajoute l’esclave elle-même.

3Installer et configurer l’esclave

Option A — par SSH depuis le maîtreLe plus rapide. Le maître installe le panneau sur le nouveau serveur et le configure.
Option B — à la mainSi le maître n’a pas d’accès SSH root ou si le panneau y est déjà installé.

Option A — installation SSH

Sur le maître : Channels → Balancers → SSH installation (en haut à droite).

La fenêtre d’installation SSH : IP, port, mot de passe, nom et pays
  1. Adresse IP du nouveau serveur.
  2. Port SSH (généralement 22). L’utilisateur est root.
  3. Mot de passe root. Utilisé uniquement pour cette installation.
  4. Nom de l’esclave, par ex. DE-1.
  5. Pays et réseaux — comme à l’étape 2.
  6. Panel language de l’esclave.
  7. Stream workers — laissez auto : le maître lit le nombre de cœurs du nouveau serveur pendant l’installation.
  8. Source read, ms — 20.
  9. Start install. La progression s’affiche dans le cadre noir.

Le maître installe le panneau, en fait un esclave pointant vers lui, y inscrit l’Id et la clé, active Admin login from master, puis l’ajoute à la liste. On se connecte au panneau de l’esclave avec le même utilisateur et le même mot de passe admin que sur le maître (après la première synchronisation, jusqu’à 60 s après le démarrage). Après quelques minutes, l’esclave apparaît online — voir l’étape 4.

Option B — à la main

1. Installez le panneau sur le nouveau serveur comme d’habitude (en root) :

curl -s https://nice-panel.com/install3.sh | bash -s 5.5

2. Connectez-vous au panneau de l’esclave → Configuration → BALANCER :

Configuration → BALANCER sur l’esclave : type, maître, Id, clé, débit réseau, connexion admin
  1. Balancer type → Slave.
  2. Master — l’adresse du maître avec le port du panneau : IP:4300.
  3. Balancer Id — le même que dans la liste du maître (étape 2). Avec une clé, le maître reconnaît l’esclave grâce à lui, quelle que soit son IP (IP dynamique, NAT, autre adresse sortante).
  4. Balancer key — la même clé que sur le maître.
  5. Network speed (Mbps) — 0 = lu sur la carte réseau. Saisissez une valeur (1000, 10000) sur un serveur virtuel ou si le port/l’offre est plus lent que la carte.
  6. Admin login from master — No : l’esclave garde son propre utilisateur admin et son mot de passe. Yes : il les reprend du maître.

3. Save. L’esclave télécharge tout depuis le maître : chaînes, abonnés, EPG, VOD, réglages et logos. Si le maître utilise d’autres ports, l’esclave les reprend et redémarre de lui-même.

4. Si ce n’est pas déjà fait, ajoutez l’esclave dans la liste du maître (étape 2).

Réglages de l’esclave depuis le maître

La page Configuration d’un esclave est limitée — la plupart des réglages viennent du maître. Trois réglages sont propres à chaque esclave et se font sur le maître, dans sa ligne de Balancers (Add, modification ✎ ou SSH installation) :

RéglageRôle
Panel languagela langue du panneau de l’esclave. Appliquée tout de suite, sans redémarrage
Stream workersles processus qui envoient les chaînes aux spectateurs, sur plusieurs cœurs. Auto selon les cœurs de l’esclave : jusqu’à 4 cœurs → 2, jusqu’à 8 → 4, plus de 8 → 8 (au-delà de 8, aucun gain). Ou un nombre fixe (off, 1–16)
Source read, msà quelle fréquence l’esclave lit les sources des chaînes. 20 par défaut ; 0 = désactivé. Appliqué tout de suite
Quand l’esclave redémarre

Le nombre de processus prend effet après un redémarrage : l’esclave redémarre donc tout seul — uniquement si la valeur change vraiment. Ses spectateurs sont coupés quelques secondes. Avec l’installation SSH, le bon nombre est écrit dès l’installation : pas de redémarrage. Un esclave installé à la main le reçoit à son premier contact avec le maître — un redémarrage.

4Vérifier l’état

Sur le maître : Channels → Balancers. L’état de chaque esclave est actualisé toutes les 5 secondes.

La liste des répartiteurs : trois esclaves online, protégés, avec clients, CPU, RAM, réseau et charge
Trois esclaves online et protégés, avec leurs clients et leurs mesures. BG-1 a une carte 1 Gbit/s et c’est le plus chargé : les nouveaux spectateurs d’Allemagne vont donc vers DE-2.
AffichéSignification
● online / offlinesi l’esclave a interrogé le maître au cours des 150 dernières secondes. Le numéro passe au vert ou au rouge
protected / unprotectedavec clé / ancien protocole sans clé
from <IP>l’esclave se connecte depuis une autre IP que son adresse (NAT, nom d’hôte) — à titre d’information
N clientsnombre de spectateurs servis par l’esclave
EN / BGla langue du panneau choisie pour l’esclave
CPU · RAM · Mbpsutilisation du processeur (cœurs), de la mémoire et du réseau (trafic / débit de la carte)
workers N (auto) · read N msles stream workers et le source read réels de l’esclave. Un → N orange signifie qu’une nouvelle valeur attend le redémarrage
load %la plus chargée des trois ressources. L’esclave est choisi d’après elle ; au-delà de 90 %, elle est mise en évidence
syncquand l’esclave a confirmé les données pour la dernière fois
changes waiting (N)combien de types de données il n’a pas encore téléchargés. Normal peu après une modification ou un redémarrage

Chaque panneau affiche aussi son rôle sous le logo, sur toutes les pages — vous savez toujours dans quel panneau vous êtes :

L’en-tête du maître : MASTER en rouge sous le logo
MASTER — en rouge
L’en-tête d’un esclave : SLAVE (201) en orange sous le logo, étiquette du serveur en orange
SLAVE (Id) — en orange, avec l’Id de l’esclave dans la liste du maître ; l’étiquette du serveur est aussi orange

5Quel spectateur vers quel serveur

À chaque nouvelle connexion, le maître vérifie les règles dans l’ordre et s’arrête à la première qui donne un esclave actif :

RègleComment la définir
1. ManuelleUsers → champ Balancer de l’abonné (ou en masse pour la sélection). Toujours prioritaire tant que cet esclave est actif
2. Sous-réseaul’IP du spectateur fait partie d’un sous-réseau ou d’une IP du champ « pays » d’un répartiteur
3. Paysle pays GeoIP du spectateur figure dans le champ « pays »
4. Maîtrerien ne correspond ou ces esclaves sont hors service : le spectateur reste sur le maître

Plusieurs esclaves pour un même lieu

Si un pays ou un réseau a plusieurs esclaves actifs, le nouveau spectateur va vers le moins chargé. Ce n’est pas du round robin : la charge est le maximum du processeur, de la mémoire et du réseau, si bien qu’un serveur avec une carte plus rapide ou plus de cœurs reçoit proportionnellement plus de spectateurs. En cas d’égalité (à 5 points près), c’est l’abonné qui décide : un même abonné retombe toujours sur le même serveur.

Un esclave tombe

Un esclave qui n’a pas interrogé le maître depuis plus de 150 s est ignoré. La redirection est temporaire (302) : la connexion suivante du spectateur repasse par le maître et arrive sur un serveur actif. Si le maître est injoignable au démarrage d’un esclave, celui-ci démarre avec les dernières données reçues.

Limite de connexions

Avec une clé, la limite de l’abonné est commune à tous les serveurs : 2 connexions autorisées, c’est 2 au total, pas 2 par serveur.

Si quelque chose ne fonctionne pas

Les messages se trouvent dans le journal du panneau et commencent par [BAL].

Message / symptômeQue faire
old protocol – set the same bal_key therele maître a une clé, pas l’esclave. Saisissez la clé sur l’esclave
bal_key mismatchles clés diffèrent ou les horloges ont plus de 10 minutes d’écart
unknown slave … set the same Idl’Id de l’esclave manque ou n’est pas dans la liste du maître
IP not allowedsans clé, l’esclave doit se connecter depuis l’IP de son adresse. Avec une clé, renseignez l’Id de l’esclave
master … – no syncl’esclave n’atteint pas le maître : réseau, pare-feu, port 4300
« offline » sur le maîtrel’esclave est arrêté ou n’atteint pas le maître. Ses spectateurs vont vers les autres serveurs
« speed unknown »la carte virtuelle n’indique pas son débit. Renseignez Network speed sur l’esclave
Passer à une clé sur une installation en service
  • mettez à jour le maître et tous les esclaves ;
  • définissez la clé (et l’Id) sur les esclaves ;
  • en dernier, sur le maître.

Tant que les clés ne correspondent pas, les esclaves continuent avec les dernières données reçues.