Migrazione da xaccel-codec
Aggiornato il 04 ott 2026Sposta canali, sorgenti, uscite, impostazioni di transcodifica e adattatori DVB da xaccel-codec a Castreon direttamente dal pannello, in pochi minuti. xaccel continua a funzionare per tutto il tempo e nulla viene scritto finché non confermi.
Disponibile da Castreon 1.0.3. Supportato: xaccel-codec 5.x (testato con 5.5.17).
Come funziona
- Carichi il backup automatico che xaccel tiene già sul suo server.
- Castreon lo legge e ti mostra un report: cosa verrà creato, cosa non può essere mantenuto e perché. Per ora non cambia nulla.
- Confermi. I canali vengono creati fermi, così le sorgenti non vengono prelevate due volte mentre xaccel è ancora attivo.
- Controlli i canali, li avvii e sposti i load balancer. Gli indirizzi vecchi degli stream di xaccel continuano a funzionare in Castreon.
Il backup viene solo letto. Castreon non si collega a xaccel, non lo ferma e non vi modifica nulla.
Prima di iniziare
- Castreon è installato e attivato sul server verso cui migri: vedi Installazione e attivazione.
- Il tuo piano copre il numero di canali che vuoi far funzionare contemporaneamente.
- Sorgenti DVB: le schede DVB devono essere nel server Castreon. Se Castreon gira sullo stesso server di xaccel, una scheda può essere usata da un solo programma alla volta: ferma xaccel (o i canali che usano quella scheda) prima di avviare i canali DVB in Castreon.
- Se ricevi anche con Astra (Cesbo), carica la sua configurazione nella stessa analisi: vedi Migrazione da Astra (Cesbo).
1. Copia il backup di xaccel
xaccel tiene i backup automatici in /opt/xaccel-codec/backup/. Sul server xaccel, elencali dal più recente:
ls -lt /opt/xaccel-codec/backup/
I file si chiamano xaccel-codec-<versione>-<data>-<id>.gz. Copia il più recente sul tuo computer, per esempio:
scp root@SERVER-XACCEL:/opt/xaccel-codec/backup/xaccel-codec-5.5.17-20261004182209-3e042dc4.gz .
Usa il file più recente: le modifiche fatte in xaccel dopo la data nel nome del file non sono incluse.
Tratta il backup con cura. Contiene gli account e le password di xaccel. Castreon non li legge, ma il file li contiene: tienilo su un computer affidabile ed eliminalo a migrazione conclusa.
2. Analizza
- Nel pannello Castreon, apri Impostazioni → Migrazione (xaccel, Astra).
- In Backup xaccel-codec, scegli il file
.gz. - Fai clic su Analizza.
Sono accettati anche backup di diversi gigabyte (per esempio con dati EPG). L'analisi resta valida 30 minuti; dopo, carica di nuovo il file.
3. Leggi il report
In alto, quattro cifre riassumono l'importazione:
| Cifra | Significato |
|---|---|
| Canali | i canali che verranno creati e quanti funzionano senza transcodifica (passthrough) |
| Nuovi profili | i profili di transcodifica che verranno creati; i canali con impostazioni identiche condividono un profilo |
| Uscite | uscite HLS, HTTP-TS e push (UDP, SRT, RTMP) |
| Altro | nuovi adattatori DVB, gruppi e indirizzi IP consentiti; gli adattatori già esistenti vengono riutilizzati |
La tabella elenca ogni canale:
- Canale — nome, nome nell'indirizzo (slug) e gruppo;
- Sorgente — la sorgente principale, per esempio
DVB · Cavo 610 · SID 40805oHTTP; - Profilo — il profilo di transcodifica, oppure passthrough;
- Uscite — HLS, HTTP-TS, UDP…;
- Indirizzo vecchio — l'indirizzo xaccel che continuerà a funzionare, per esempio
/stream/15/30015.m3u8; - Da sapere — ciò che non è stato possibile mantenere per questo canale.
Sotto la tabella:
- Profili e Adattatori DVB — cosa verrà creato; esiste già, viene usato quello significa che non viene creato nulla di nuovo;
- Impostazioni non mantenute — impostazioni senza equivalente, con il numero di canali interessati;
- Cosa non viene migrato — dati lasciati fuori di proposito (vedi sotto).
Indirizzi consentiti
Se xaccel aveva una lista di IP consentiti, il report propone Aggiungi i N indirizzi consentiti da xaccel. La lista vale subito per tutti i canali: player e load balancer che non sono nella lista vengono rifiutati (HTTP 403). Spuntala solo se la lista è completa, compresi gli indirizzi dei tuoi load balancer. Puoi cambiarla in qualsiasi momento in Impostazioni → Accesso ai flussi: vedi Riavvii pianificati e restrizioni IP.
4. Importa
Fai clic su Importa N canali (fermi). Prima vengono creati gruppi, adattatori DVB e profili; se uno di questi non riesce, non viene mantenuto nulla. Poi i canali vengono creati uno alla volta: un canale che non può essere creato (per esempio senza alcuna sorgente utilizzabile) compare in Non è stato possibile importare, gli altri vengono importati.
5. Controlla e avvia
- Apri Canali. I canali importati sono fermi; le loro note contengono il numero dello stream di xaccel.
- Apri alcuni canali e controlla sorgenti, profilo e uscite. Una sorgente DVB mostra l'adattatore e il servizio (SID).
- Per il DVB, apri Adattatori DVB e controlla che ogni adattatore sia agganciato al segnale: vedi Adattatori DVB, tuner e scansione.
- Avvia i canali, pochi alla volta, e confrontali con xaccel.
6. Il passaggio
Gli indirizzi vecchi di xaccel funzionano in Castreon sulla porta del pannello (33400 di default):
| xaccel | Castreon |
|---|---|
http://XACCEL:33200/stream/15/30015.m3u8 |
http://CASTREON:33400/stream/15/30015.m3u8 (la playlist HLS del canale) |
http://XACCEL:33200/stream/15/axn.ts |
http://CASTREON:33400/stream/15/axn.ts (il flusso HTTP-TS del canale) |
Nei load balancer cambi solo host e porta. Valgono le stesse regole di accesso degli indirizzi normali di Castreon: vedi Distribuzione.
Quando tutto funziona in Castreon, ferma xaccel.
Cosa viene migrato
| xaccel | Castreon |
|---|---|
| Nome del canale, URL del logo, ID EPG, modalità on demand | lo stesso sul canale Castreon; lo slug viene creato dal nome |
| Sorgenti (HTTP/HTTPS, UDP/RTP, SRT, RIST, RTMP, RTSP), nell'ordine di failover | sorgenti del canale, con user agent, header e referer |
Sorgenti DVB (dvb://… e servizi scansionati) |
sorgente DVB collegata all'adattatore importato, con il SID del servizio |
| Mappatura video, audio e sottotitoli, rate emulation | lo stesso su ogni sorgente |
| Encoder video e audio (NVENC, QSV, VAAPI, CPU; H.264, HEVC, AV1, VP9; AAC, Opus, AC-3, E-AC-3, MP3), bitrate, dimensione, preset, GOP, deinterlacciamento, testo in sovrimpressione | un profilo di transcodifica: vedi Profili di transcodifica |
| Video e audio copiati, senza sovrimpressioni | passthrough (nessun profilo) |
| Sottotitoli impressi, copiati o WebVTT | la modalità sottotitoli del canale |
| Riavvii pianificati | i riavvii pianificati del canale |
| Categorie | gruppi di canali |
| Uscite HLS, HTTP, UDP/RTP, SRT, RTMP | HLS (con durata del segmento e lunghezza della playlist), HTTP-TS, uscite push |
| Sintonizzazione DVB-C, DVB-T e DVB-T2 | adattatori DVB |
| Lista di IP consentiti | indirizzi consentiti (facoltativo) |
Cosa non viene migrato
- account, utenti e pacchetti di rivendita di xaccel;
- la licenza di xaccel e i dati del server;
- VOD (film e serie) e dati EPG — l'ID EPG di ogni canale viene mantenuto;
- il bilanciamento e i proxy di xaccel;
- le impostazioni di accesso condizionato;
- le sorgenti con chiavi nell'indirizzo — il canale riceve una nota; aggiungile manualmente;
- gli adattatori satellitari (DVB-S/S2) — segnalati nel report; per ora Castreon supporta solo la ricezione via cavo e terrestre;
- i loghi caricati in xaccel come file (caricali di nuovo nel profilo), il volume audio modificato, la rimozione del logo (delogo), il timeshift;
- il riavvio giornaliero globale di xaccel — Castreon non ne ha bisogno; puoi aggiungere un riavvio pianificato per canale.
Ripetere l'importazione
L'importazione si può ripetere senza rischi, con lo stesso backup o con uno più recente:
- i canali già importati vengono riconosciuti dal numero dello stream di xaccel e non vengono duplicati;
- i profili e gli adattatori DVB già importati vengono riutilizzati;
- per importare di nuovo un canale, eliminalo prima in Castreon, poi esegui l'importazione.
Gli indirizzi vecchi sono legati al numero dello stream di xaccel. Se riunisci più server xaccel in un solo Castreon, i canali con lo stesso numero di stream su server diversi vengono trattati come lo stesso canale. Migra questi server su server Castreon separati, oppure apri un ticket e ti aiutiamo.
Se qualcosa non va
- «Il file non sembra un backup di xaccel-codec» — usa un file di
/opt/xaccel-codec/backup/(xaccel-codec-<versione>-….gz), non un export del database fatto in altro modo. - «L'analisi è scaduta» — sono passati più di 30 minuti tra l'analisi e l'importazione; carica di nuovo il file.
- I player ricevono HTTP 403 dopo l'importazione — è stata importata la lista degli indirizzi consentiti e loro non ci sono; correggila in Impostazioni → Accesso ai flussi.
- Un canale non parte a causa della licenza — il tuo piano consente meno canali attivi; ferma altri canali o passa a un piano superiore.
- Un canale DVB non parte — controlla in Adattatori DVB che l'adattatore sia attivato e agganciato e che nessun altro programma (xaccel, Astra) usi la scheda.
- Un canale compare in «Non è stato possibile importare» — leggi il motivo accanto; di solito il canale non aveva nessuna sorgente utilizzabile da Castreon. Crealo manualmente.
Se il problema persiste, apri un ticket e allega il report (basta uno screenshot): vedi Come aprire un buon ticket.