Come migrare Dolibarr su un nuovo server senza perdere dati: una guida completa

Sommario

1. Introduzione

2. Perché potrebbe essere necessario migrare Dolibarr

3. Comprensione della struttura dei file e del database di Dolibarr

4. Preparazione per una migrazione: strategia di backup

5. Scelta del nuovo ambiente di hosting

6. Installazione dei prerequisiti sul nuovo server

7. Backup del database Dolibarr

8. Esportazione dei file di configurazione e dei documenti di Dolibarr

9. Trasferimento sicuro dei file sul nuovo server

10. Ripristino del database sul nuovo server

11. Regolazione del file di configurazione (conf.php)

12. Impostazione delle autorizzazioni e delle proprietà delle directory

13. Test dell'istanza ripristinata

14. Considerazioni su DNS e propagazione del dominio

15. Gestione delle differenze di versione durante la migrazione

16. Pulizia e ottimizzazione post-migrazione

17. Errori comuni e come risolverli

18. Migrazione di moduli e plugin personalizzati

19. Garantire la compatibilità con le integrazioni esterne

20. Controlli di integrità dei dati dopo la migrazione

21. Gestione dell'accesso degli utenti durante il passaggio

22. Piano di backup e rollback finale

23. Migliori pratiche di sicurezza durante la migrazione

24. Pianificazione dei tempi di inattività e comunicazione con le parti interessate

25. Conclusione: migrazione affidabile senza perdita di dati

1. introduzione

Migrare il tuo sistema ERP/CRM Dolibarr su un nuovo server può sembrare scoraggiante, soprattutto quando l'integrità dei dati e la continuità del servizio sono fondamentali. Che tu stia cambiando provider di hosting, aggiornando l'hardware o passando a un cloud privato, questa guida ti guiderà passo dopo passo attraverso il processo di migrazione, senza perdere un solo byte di dati.

2. Perché potrebbe essere necessario migrare Dolibarr

Gli scenari comuni includono:

• Passaggio da hosting condiviso a VPS o hosting dedicato

• Passaggio da un server di test a uno di produzione

• Passare a un provider cloud

• Aggiornamento del sistema operativo o dell'infrastruttura

La migrazione garantisce migliori prestazioni, flessibilità e sicurezza, se eseguita correttamente.

3. Comprensione della struttura dei file e del database di Dolibarr

Dolibarr si basa su due componenti principali:

• Banca Dati (MySQL/MariaDB): memorizza tutti i dati aziendali: clienti, fatture, inventario, ecc.

• File system: Contiene file di configurazione, moduli, documenti caricati dall'utente (PDF, immagini) e /htdocs/ cartella dell'applicazione

Per una migrazione completa sono necessari entrambi.

4. Preparazione per una migrazione: strategia di backup

Prima di fare qualsiasi cosa:

• Eseguire il backup del database utilizzando mysqldump

• Archivia la directory completa di Dolibarr (per esempio, /var/www/dolibarr)

• Conservare i backup in due posizioni sicure

È inoltre opportuno informare gli utenti della finestra di manutenzione e disabilitare temporaneamente l'accesso in scrittura.

5. Scelta del nuovo ambiente di hosting

Assicurati che il tuo nuovo server supporti:

• PHP 7.4+ o PHP 8.1+

• MySQL o MariaDB

• Apache o Nginx

• Estensioni PHP richieste: gd, curl, mbstring, json, ecc.

Evitare stack di server incompatibili o vecchi.

6. Installazione dei prerequisiti sul nuovo server

Installa i pacchetti necessari:

sudo apt update
sudo apt install apache2 mariadb-server php php-mysql php-gd php-curl php-mbstring php-xml unzip

Quindi abilitare i moduli Apache richiesti:

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

7. Backup del database Dolibarr

Usa il mysqldump o phpMyAdmin:

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql

Assicurati che il tuo dump includa:

• Tutti i tavoli

• Struttura della tabella e dati

• Set di caratteri UTF-8 (per caratteri non inglesi)

8. Esportazione dei file di configurazione e dei documenti di Dolibarr

Utilizza tar o zip per archiviare la tua cartella Dolibarr:

tar czf dolibarr_files.tar.gz /var/www/dolibarr

In questo modo vengono preservati la struttura delle directory, i permessi e i collegamenti simbolici.

9. Trasferimento sicuro dei file al nuovo server

Usa il scp or rsync per il trasferimento sicuro:

scp dolibarr_backup.sql user@newserver:/home/user/
scp dolibarr_files.tar.gz user@newserver:/home/user/

In alternativa, utilizzare SFTP o un dispositivo USB in ambienti air-gapped.

10. Ripristino del database sul nuovo server

Accedi a MySQL e importa:

mysql -u root -p
CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit
mysql -u root -p dolibarr_db < dolibarr_backup.sql

Assicurati che le credenziali dell'utente corrispondano a quelle in conf.php.

11. Regolazione del file di configurazione (conf.php)

Apri htdocs/conf/conf.php e aggiorna:

• db_host

• db_user

• db_pass

• db_name

• dolibarr_main_url_root

Assicurati che gli URL corrispondano al nuovo dominio o IP del server.

12. Impostazione delle autorizzazioni e delle proprietà delle directory

Imposta i permessi utente corretti:

chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr

Questi garantiscono l'accesso del server web ai file Dolibarr.

13. Test dell'istanza ripristinata

Accedi alla pagina di accesso di Dolibarr al nuovo URL. Verifica:

• Connettività del database

• Funzionalità di accesso

• Generazione PDF

• Attivazione del modulo

Per risolvere i problemi, utilizza gli strumenti di sviluppo del browser o i registri degli errori PHP.

14. Considerazioni su DNS e propagazione del dominio

Se stai cambiando dominio:

• Aggiorna i record DNS A al nuovo IP del server

• Configura HTTPS con Let's Encrypt o altri SSL

• Consentire 24-48 ore per la propagazione DNS globale

15. Gestire le differenze di versione durante la migrazione

Se il tuo nuovo server utilizza una versione più recente di Dolibarr:

• Seguire le procedure di aggiornamento prima della migrazione

• Esegui il programma di installazione di Dolibarr su /install/ per aggiornare lo schema del database

Non ripristinare mai un backup precedente su un'installazione più recente senza effettuare la migrazione.

16. Pulizia e ottimizzazione post-migrazione

Le attività post-migrazione includono:

• Eliminazione .sql e .tar.gz file di backup

• Rimozione di cartelle temporanee o cache

• Esecuzione di script di ottimizzazione del database

• Controllo di moduli o dati inutilizzati

17. Errori comuni e come risolverli

18. Migrazione di moduli e plugin personalizzati

Copia tutti i moduli personalizzati da: /htdocs/custom/

Migrare anche:

• File di lingua

• Temi personalizzati o CSS

• Modelli e ganci aggiuntivi

Assicurati che siano compatibili con la tua versione di Dolibarr.

19. Garantire la compatibilità con le integrazioni esterne

Dopo la migrazione, testare:

• Endpoint API

• Ponti WooCommerce o Prestashop

• Impostazioni SMTP della posta elettronica

• Webhook o script CRON

Aggiornare gli IP o i token secondo necessità nelle piattaforme connesse.

20. Controlli di integrità dei dati dopo la migrazione

Convalidare:

• I totali delle fatture corrispondono ai vecchi record

• I dati dei clienti e dei fornitori sono intatti

• I report corrispondono agli snapshot pre-migrazione

• Nessun file mancante in /documents/

Utilizzare query SQL per verificare nuovamente i record casuali.

21. Gestione dell'accesso degli utenti durante il passaggio

La migliore pratica:

• Informare gli utenti in anticipo

• Blocca l'accesso durante il backup

• Consenti l'accesso solo dopo aver testato sul nuovo server

Se i tempi di inattività sono minimi, si consiglia di impostare una modalità di sola lettura temporanea.

22. Piano di backup e rollback finale

Sempre:

• Backup del nuovo server dopo la migrazione riuscita

• Conservare lo snapshot del vecchio server per almeno 7 giorni

• Documentare tutti i passaggi e i problemi durante la migrazione

Ciò fornisce una rete di sicurezza in caso di bug post-migrazione.

23. Migliori pratiche di sicurezza durante la migrazione

• Utilizzare SSH/SFTP, non FTP

• Ruotare le password DB e amministratore dopo la migrazione

• Proteggi il firewall e le impostazioni PHP del tuo nuovo server

• Abilita HTTPS immediatamente

24. Pianificazione dei tempi di inattività e comunicazione con le parti interessate

Notifica ai clienti e agli utenti:

• Finestra di inattività prevista

• Eventuali modifiche agli URL o agli accessi

• Contatti di supporto in caso di problemi

Se possibile, pianificare la migrazione in orari non di punta.

25. Conclusione: migrazione affidabile senza perdita di dati

La migrazione di Dolibarr su un nuovo server è sicura e gestibile se eseguita con i giusti passaggi. Con un'attenta pianificazione, un backup accurato e la verifica di ogni fase, è possibile passare a un'infrastruttura o a un provider di hosting più potente senza interruzioni del servizio o perdita di dati.

Che tu voglia ampliare le tue operazioni o migliorare la sicurezza, questa migrazione contribuirà a garantire che Dolibarr rimanga un pilastro stabile delle tue operazioni aziendali.