Migrare da cPanel a Plesk con Plesk Migrator: config.ini e comandi da terminale

Chi gestisce un parco server e deve spostare clienti da cPanel a Plesk di solito cerca due cose: il comando giusto e la lista di quello che si rompe. Questa guida copre entrambe, con la sintassi verificata sulla documentazione ufficiale Plesk (docs.plesk.com, versione Obsidian) e sui knowledge base di supporto Plesk.

Prima di iniziare: porte e DNS

Plesk Migrator si collega al server cPanel di origine via SSH, come root. Il firewall del server sorgente deve avere la porta SSH aperta (22 di default, o quella custom indicata in config.ini con ssh-port) verso il server Plesk di destinazione. Senza questo, il comando check fallisce già al primo passaggio.

Il secondo punto riguarda il DNS: i nomi a dominio devono puntare al nuovo server solo dopo che la migrazione è stata verificata. Prima di partire conviene abbassare il TTL delle zone DNS dei domini coinvolti (per esempio a 300 secondi), così il cutover finale non resta bloccato per ore dalla cache dei resolver. Questo passaggio non è automatizzato da Plesk Migrator: va fatto a mano sul pannello DNS in uso, con qualche giorno di anticipo rispetto alla data di migrazione.

Installare l'estensione e preparare config.ini

Sul server Plesk di destinazione, l'estensione Plesk Migrator si installa da Extensions, cercandola nella barra di ricerca del catalogo. Da riga di comando, invece, si lavora così:

mkdir /usr/local/psa/var/modules/panel-migrator/conf
cd /usr/local/psa/var/modules/panel-migrator/conf/

Qui va creato il file config.ini. Il contenuto minimo è: [GLOBAL] source-type: cpanel source-servers: cpanel target-type: plesk [plesk] ip: os: unix [cpanel] ip: os: unix ssh-password:

Se la porta SSH del server cPanel non è la 22, va aggiunta la riga ssh-port sotto la sezione [cpanel], come segnalato nei template ufficiali.

Esistono due famiglie di file di esempio nella cartella /usr/local/psa/admin/plib/modules/panel-migrator/backend/conf/samples/: i file plesk-unix.simple.ini, cpanel.simple.ini, confixx.simple.ini e ppcpl.simple.ini contengono solo il minimo indispensabile per la migrazione, mentre plesk-unix.ini, cpanel.ini, confixx.ini e ppcpl.ini sono file di configurazione completi e commentati che permettono di regolare molte opzioni aggiuntive. Per una prima migrazione di prova basta la versione "simple"; per ambienti con database PostgreSQL o configurazioni non standard conviene partire dalla versione completa.

Se il server cPanel ospita database PostgreSQL, la password dell'utente admin PostgreSQL va aggiunta esplicitamente nel config.ini, altrimenti quei database non vengono migrati.

I tre comandi che fanno il lavoro

Con config.ini pronto, la sequenza da terminale è sempre la stessa, lanciata da /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator:

1. Generazione della lista di migrazione: il comando da eseguire è /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list. Il file risultante si chiama migration-list e viene collocato nella directory /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/. È un elenco di oggetti — account cliente e reseller, piani di servizio, domini e così via — da migrare, modificabile a mano per escludere domini o riassegnarli a piani di hosting diversi.

2. Controllo pre-migrazione: prima di lanciare il trasferimento vero e proprio conviene eseguire plesk-migrator check. Questo comando segnala tutti i potenziali problemi che si incontrerebbero durante la migrazione, prima che venga eseguita qualsiasi azione.

3. Avvio del trasferimento: per avviare la migrazione si lancia /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts. Se non emergono problemi critici, tutti i domini, i client, i reseller e gli altri oggetti elencati nella migration list vengono creati sul server di destinazione, comprese le impostazioni di hosting: domini aggiuntivi, sottodomini, alias, database, caselle di posta e account.

Se dopo il primo passaggio serve un secondo sync (per esempio per recuperare le modifiche fatte sul server cPanel nei giorni successivi, prima del cutover DNS finale), il comando da usare non è di nuovo transfer-accounts a secco ma transfer-accounts --reload-source-data, che aggiorna i dati letti dal server di origine senza ripartire da zero.

Cosa non si trasferisce automaticamente

Plesk Migrator copre la gran parte degli oggetti standard di un hosting cPanel: domini, sottodomini, database, caselle email, piani di hosting. Restano fuori, o richiedono intervento manuale, alcuni elementi specifici di cPanel che la stessa community segnala ricorrentemente nei forum di supporto: configurazioni personalizzate di cron job non standard, regole custom negli .htaccess che dipendono da moduli Apache non presenti su Plesk, certificati SSL autoinstallati fuori dal flusso AutoSSL/Let's Encrypt, liste Mailman e alcuni plugin cPanel di terze parti senza equivalente in Plesk. In tutti questi casi il consiglio pratico è non fidarsi del solo output di transfer-accounts: va fatto un controllo manuale dominio per dominio sugli elementi non standard prima di spegnere il vecchio server.

Migrare le email separatamente

La posta elettronica viaggia insieme al resto se nel config.ini è impostato il parametro di copia del contenuto mail, ma su mailbox voluminose o server con vincoli di banda conviene gestirla come passaggio a parte, con un client o un tool IMAP dedicato (per esempio imapsync), lanciato dopo che gli account e i domini sono già stati creati su Plesk. Questo riduce il rischio di timeout durante il transfer-accounts principale e permette di ripetere solo la sincronizzazione della posta più volte, senza ritoccare database e file web già migrati.

Verifica finale prima del cutover

Prima di spostare il DNS in produzione sul nuovo server, tre controlli pratici:

• Conteggio domini: il numero di domini attivi in Plesk (Websites & Domains) deve coincidere con quello del pannello cPanel di origine.
• Invio di una email di prova da e verso ogni dominio migrato, per controllare che l'MX e l'autenticazione SMTP/IMAP funzionino sul nuovo server.
• Controllo delle zone DNS: ogni dominio deve avere sul nuovo Plesk gli stessi record (A, MX, CNAME, TXT per SPF/DKIM) presenti sul vecchio server, confrontando zona per zona.

Solo dopo questi controlli ha senso alzare di nuovo il TTL delle zone DNS e considerare chiuso il vecchio server cPanel.

Al termine, un'ultima verifica di stato è prevista dalla stessa documentazione Plesk: il comando plesk-migrator test-all, lanciato dopo transfer-accounts, serve a controllare lo stato degli oggetti migrati sul server di destinazione.

Plesk è un prodotto di WebPros International GmbH, non di Prime Software.