1. Panoramica della Strategia di Migrazione
Questa guida fornisce una procedura dettagliata e orientata all’operatività per trasferire gli apparati Enterprise da cnMaestro Cloud a un’infrastruttura cnMaestro On-Premises (On-Prem). La migrazione assicura la piena sovranità dei dati e il mantenimento di tutte le funzionalità avanzate di gestione senza interruzione dei servizi di rete.
Prerequisiti Fondamentali
• Server On-Premises Pronto: Installa l’ultima release disponibile (versione 6.0 o superiore) su hypervisor supportato (VMware ESXi, KVM, MS Hyper-V), scaricabile da qui.
• Connettività di Rete: Assicurarsi che gli apparati (Switch, AP) possano raggiungere l’IP/FQDN della VM locale sulle porte HTTPS (443) e Truncated MQTT (1883/8883).
• Setup Cloud Anchor Account: Prima di avviare il processo, creare un account Anchor su cnMaestro Cloud. Questo permette di estendere e sincronizzare le licenze cnMaestro X locali con 90 giorni di operatività prolungata.
2. Workflow di Migrazione Passo-Passo
| Fase | Azione Operativa | Note & Buone Pratiche |
| Fase 1 | Backup Configurazioni Cloud | Export dei file di configurazione (.json/.csv) e salvataggio manuale delle regole switch avanzate (es. vlan override porta per porta). |
| Fase 2 | Inizializzazione VM On-Prem | Import dell’OVA/QCOW2, configurazione IP statico e associazione del Cloud Anchor Account per il riscatto dei 90 giorni di licenza cnMaestro X. |
| Fase 3 | Unboarding da Cloud & Claim Local | Rimuovere i dispositivi dal Cloud in lotti (batch). Inserire i Serial Number (o utilizzare Option 43 DHCP) per l’approvazione On-Premises. |
| Fase 4 | Verifica & Audit | Confermare il ripristino dei tunnel di gestione, la sync delle policy e il corretto passaggio dei log e dell’option 43. |
3. Punti di Attenzione Hardware & Virtualizzazione
⛔ NON CLONARE LE MACCHINE VIRTUALI (VM)
Le istanze VM di cnMaestro On-Premises generano un ID sintetico univoco durante il primo avvio. Clonare una VM esistente causa duplicazione d’identità, provocando il blocco della sincronizzazione con il Cloud Anchor Account e la sovrascrittura delle licenze.
Discrepanza Feature Switch (Cloud 6.3 vs On-Prem 6.0): Le funzionalità avanzate di configurazione porte switch introdotte nella versione Cloud 6.3 devono essere salvate manualmente. Nella versione On-Premises 6.0, tali opzioni vanno riapplicate tramite template CLI o configurazione puntuale.
4. Domande Frequenti (FAQ Ufficiali – Aggiornato 18 Sep 2026)
Q1: Perché Cambium consiglia la migrazione a On-Premises per i clienti Enterprise?
R: Per offrire un controllo completo sulla riservatezza dei dati, latenze ridotte nella gestione locale e continuità operativa personalizzata per infrastrutture complesse e critiche.
Q2: Cosa succede alle mie licenze cnMaestro X attive su Cloud?
R: Collegando la nuova VM On-Premises al Cloud Anchor Account, le licenze cnMaestro X attive vengono accreditate e convertite per l’uso locale con un periodo extra promozionale di 90 giorni.
Q3: I dispositivi perderanno la connettività di rete (traffico dati) durante il passaggio?
R: No. La migrazione influisce esclusivamente sul piano di gestione (control plane). Il traffico utenti (data plane) e il routing continuo a funzionare senza alcuna interruzione.
Q4: Come posso reindirizzare automaticamente gli AP/Switch alla VM locale senza toccarli uno per uno?
R: È consigliato utilizzare l’Option 43 del server DHCP locale, oppure aggiornare il record DNS ‘cnmaestro.local’ con l’indirizzo IP della nuova VM On-Premises.
Q5: Posso ripristinare un backup completo del database Cloud sulla VM On-Premises?
R: No, il ripristino diretto del DB Cloud su On-Premises non è supportato a causa delle differenti strutture di versione. È necessario esportare/importare i template e rieseguire l’onboarding degli apparati.