Hoe u Dolibarr naar een nieuwe server migreert zonder gegevensverlies: een complete gids

Inhoudsopgave

1. Introductie

2. Waarom u Dolibarr mogelijk moet migreren

3. Inzicht in de bestands- en databasestructuur van Dolibarr

4. Voorbereiding op een migratie: back-upstrategie

5. Uw nieuwe hostingomgeving kiezen

6. Vereisten installeren op de nieuwe server

7. Een back-up maken van de Dolibarr-database

8. Dolibarr's document- en configuratiebestanden exporteren

9. Bestanden veilig overbrengen naar de nieuwe server

10. De database herstellen op de nieuwe server

11. Het configuratiebestand aanpassen (conf.php)

12. Machtigingen en directory-eigendom instellen

13. Het herstelde exemplaar testen

14. Overwegingen met betrekking tot DNS en domeinpropagatie

15. Omgaan met versieverschillen tijdens migratie

16. Opschonen en optimaliseren na migratie

17. Veelvoorkomende fouten en hoe u ze kunt oplossen

18. Aangepaste modules en plug-ins migreren

19. Compatibiliteit met externe integraties garanderen

20. Gegevensintegriteitscontroles na migratie

21. Gebruikerstoegang afhandelen tijdens de overstap

22. Definitief back-up- en terugdraaiplan

23. Aanbevolen beveiligingspraktijken tijdens migratie

24. Downtime plannen en communiceren met belanghebbenden

25. Conclusie: Betrouwbare migratie zonder dataverlies

1. Inleiding

Het migreren van uw Dolibarr ERP/CRM-systeem naar een nieuwe server klinkt misschien lastig, vooral wanneer data-integriteit en servicecontinuïteit cruciaal zijn. Of u nu van hostingprovider wisselt, hardware upgradet of naar een private cloud verhuist, deze handleiding begeleidt u stap voor stap door het migratieproces, zonder ook maar één byte aan data te verliezen.

2. Waarom u Dolibarr mogelijk moet migreren

Veelvoorkomende scenario's zijn:

• Overstappen van shared hosting naar VPS of dedicated hosting

• Verhuizen van een testserver naar productie

• Overstappen naar een cloudprovider

• Upgraden van het besturingssysteem of de infrastructuur

Migratie zorgt voor betere prestaties, flexibiliteit en beveiliging, als het goed wordt uitgevoerd.

3. Inzicht in de bestands- en databasestructuur van Dolibarr

Dolibarr is gebaseerd op twee hoofdcomponenten:

• Database (MySQL/MariaDB): Slaat alle bedrijfsgegevens op: klanten, facturen, inventaris, enz.

• Bestandssysteem: Bevat configuratiebestanden, modules, door de gebruiker geüploade documenten (PDF's, afbeeldingen) en de /htdocs/ applicatiemap

Voor een volledige migratie hebt u beide nodig.

4. Voorbereiding op een migratie: back-upstrategie

Voordat u iets doet:

• Maak een back-up van de database gebruik mysqldump

• Archiveer de volledige Dolibarr-directory (Bv /var/www/dolibarr)

• Bewaar back-ups op twee veilige locaties

Het is ook verstandig om gebruikers te informeren over de onderhoudsperiode en schrijftoegang tijdelijk uit te schakelen.

5. Uw nieuwe hostingomgeving kiezen

Zorg ervoor dat uw nieuwe server het volgende ondersteunt:

• PHP 7.4+ of PHP 8.1+

• MySQL of MariaDB

• Apache of Nginx

• Vereiste PHP-extensies: gd, curl, mbstring, json, Etc.

Vermijd incompatibele of oudere serverstacks.

6. Vereisten installeren op de nieuwe server

Installeer de benodigde pakketten:

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

Schakel vervolgens de vereiste Apache-modules in:

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

7. Een back-up maken van de Dolibarr-database

Gebruik mysqldump of phpMyAdmin:

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql

Zorg ervoor dat uw stortplaats het volgende bevat:

• Alle tafels

• Tabelstructuur en gegevens

• UTF-8-tekenset (voor niet-Engelse tekens)

8. Dolibarr's document- en configuratiebestanden exporteren

Gebruik tar of zip om uw Dolibarr-map te archiveren:

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

Hierdoor blijven de directorystructuur, rechten en symbolische koppelingen behouden.

9. Bestanden veilig overbrengen naar de nieuwe server

Gebruik scp or rsync voor veilige overdracht:

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

U kunt ook SFTP of een USB-apparaat gebruiken in omgevingen zonder netwerktoegang.

10. De database herstellen op de nieuwe server

Meld u aan bij MySQL en importeer:

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

Zorg ervoor dat de gebruikersgegevens overeenkomen met die in conf.php.

11. Het configuratiebestand aanpassen (conf.php)

Open htdocs/conf/conf.php en update:

• db_host

• db_user

• db_pass

• db_name

• dolibarr_main_url_root

Zorg ervoor dat de URL's overeenkomen met het nieuwe serverdomein of IP.

12. Machtigingen en directory-eigendom instellen

Stel de juiste gebruikersrechten in:

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

Deze zorgen voor webservertoegang tot Dolibarr-bestanden.

13. Het herstelde exemplaar testen

Ga naar uw Dolibarr-inlogpagina via de nieuwe URL. Controleer:

• Database connectiviteit

• Inlogfunctionaliteit

• PDF-generatie

• Module-activering

Gebruik browser-ontwikkeltools of PHP-foutlogboeken om problemen op te sporen.

14. Overwegingen met betrekking tot DNS en domeinpropagatie

Als u van domein verandert:

• DNS A-records bijwerken naar het nieuwe server-IP

• HTTPS configureren met Let's Encrypt of andere SSL

• Houd rekening met 24–48 uur voor wereldwijde DNS-propagatie

15. Omgaan met versieverschillen tijdens migratie

Als uw nieuwe server een nieuwere versie van Dolibarr gebruikt:

• Volg de upgradeprocedures vóór de migratie

• Voer het Dolibarr-installatieprogramma uit op /install/ om het databaseschema bij te werken

Herstel nooit een oudere backup naar een nieuwere installatie zonder migratiestappen.

16. Opschonen en optimaliseren na migratie

Taken na de migratie omvatten:

• wissen .sql en .tar.gz backup bestanden

• Tijdelijke of cachemappen verwijderen

• Database-optimalisatiescripts uitvoeren

• Controleren op ongebruikte modules of gegevens

17. Veelvoorkomende fouten en hoe u ze kunt oplossen

18. Aangepaste modules en plug-ins migreren

Kopieer alle aangepaste modules van: /htdocs/custom/

Migreer ook:

• Taalbestanden

• Aangepaste thema's of CSS

• Sjablonen en extra hooks

Zorg ervoor dat ze compatibel zijn met uw Dolibarr-versie.

19. Zorgen voor compatibiliteit met externe integraties

Na migratie, test:

• API-eindpunten

• WooCommerce of Prestashop-bruggen

• E-mail SMTP-instellingen

• Webhooks of CRON-scripts

Werk IP's en tokens indien nodig bij op verbonden platforms.

20. Gegevensintegriteitscontroles na migratie

Valideren:

• Factuurtotalen komen overeen met oude gegevens

• Klant- en leveranciersgegevens zijn intact

• Rapporten komen overeen met snapshots van vóór de migratie

• Geen ontbrekende bestanden in /documents/

Gebruik SQL-query's om willekeurige records nogmaals te controleren.

21. Gebruikerstoegang afhandelen tijdens de overstap

Beste oefening:

• Gebruikers vooraf informeren

• Toegang bevriezen tijdens back-up

• Toegang alleen toestaan ​​na testen op nieuwe server

Overweeg om een ​​tijdelijke alleen-lezen-modus in te stellen als de downtime minimaal is.

22. Definitief back-up- en terugdraaiplan

Altijd:

• Back-up van nieuwe server na succesvolle migratie

• Bewaar een oude serversnapshot minimaal 7 dagen

• Documenteer alle stappen en problemen tijdens de migratie

Dit biedt een vangnet in geval van bugs na de migratie.

23. Aanbevolen beveiligingspraktijken tijdens migratie

• Gebruik SSH/SFTP, geen FTP

• Roteer DB- en beheerderswachtwoorden na migratie

• Beveilig de firewall en PHP-instellingen van uw nieuwe server

• HTTPS onmiddellijk inschakelen

24. Downtime plannen en communiceren met belanghebbenden

Klanten en gebruikers op de hoogte stellen:

• Verwachte downtime-periode

• Eventuele wijzigingen aan URL's of inloggegevens

• Ondersteuningscontacten bij problemen

Plan de migratie indien mogelijk buiten de spitsuren.

25. Conclusie: Betrouwbare migratie zonder dataverlies

Het migreren van Dolibarr naar een nieuwe server is veilig en beheersbaar met de juiste stappen. Door zorgvuldig te plannen, grondig back-ups te maken en elke fase te controleren, kunt u overstappen naar een krachtigere infrastructuur of hostingprovider zonder serviceonderbreking of dataverlies.

Of u nu uw activiteiten opschaalt of de beveiliging verbetert, deze migratie zorgt ervoor dat Dolibarr een stabiele basis blijft voor uw bedrijfsvoering.