Matomo heeft zijn eigen gids om een instance naar een nieuwe server te migreren. Het is raadzaam om een nieuwe Matomo-installatie op de nieuwe server uit te voeren. Dit betekent echter ook dat je je extra configuratiegegevens en plug-ins handmatig moet migreren. Daarom kies ik voor een eenvoudigere optie met scp/ssh.
Stap 1: De nieuwe server voorbereiden
- Afhankelijkheden installeren:
Zorg ervoor dat de nieuwe server de benodigde software heeft geïnstalleerd om Matomo te kunnen uitvoeren:- Webserver (Apache of Nginx)
- PHP (met vereiste extensies)
- MySQL/MariaDB
- Database aanmaken:
Maak op de nieuwe server een lege MySQL-database om de Matomo-gegevens in op te slaan:mysql -u root -p CREATE DATABASE new_matomo_db; VERLEEN ALLE PRIVILEGES OP new_matomo_db.* AAN 'db_gebruiker'@'localhost' GEÏDENTIFICEERD DOOR 'uw_wachtwoord'; FLUSH PRIVILEGES;Vervangennew_matomo_db,db_gebruiker, Enuw_wachtwoordmet uw gewenste databasenaam, gebruikersnaam en wachtwoord.
Stap 2: Maak een back-up van Matomo-bestanden en -databases op de oude server
- Back-up Matomo-bestanden:
Gebruikteerom een archief van uwpublieke_htmlmap (of waar Matomo ook is geïnstalleerd).tar -czf matomo_backup.tar.gz /pad/naar/public_html - Back-updatabase:
Gebruikmysqldumpom de Matomo-database te exporteren.mysqldump -u db_gebruiker -p db_naam > matomo_db_backup.sqlVervangendb_gebruikerendb_naammet de werkelijke database-inloggegevens. - Back-upbestanden overbrengen naar de nieuwe server:
U moet de back-upbestanden veilig naar de nieuwe server kopiëren met behulp vanscpU hebt ook een SSH-sleutel nodig voor toegang tussen de oude en de nieuwe server om te voorkomen dat u om een wachtwoord wordt gevraagd.scp matomo_backup.tar.gz matomo_db_backup.sql gebruiker@bestemming:/pad/naar/bestemming
Stap 3: SSH-sleutelauthenticatie tussen servers instellen
- Genereer SSH-sleutelpaar op de oude server:
Als u geen SSH-sleutelpaar hebt, genereer er dan een op de oude server:Dit genereert een privé- en publiek sleutelpaar inssh-keygen -t ed25519 -C "[email protected]"~/.ssh/id_ed25519.pub (standaard). - Kopieer de openbare sleutel naar de nieuwe server:
Gebruikssh-kopie-idom de openbare sleutel naar de nieuwe server te kopiëren:ssh-copy-id gebruiker@bestemmingMet deze opdracht wordt u eenmalig om het wachtwoord van de nieuwe server gevraagd. Vervolgens is wachtwoordloze SSH-toegang tussen de oude en de nieuwe server toegestaan. - Test SSH-toegang:
Test of u via SSH vanaf de oude server verbinding kunt maken met de nieuwe server zonder dat het wachtwoord wordt gevraagd:ssh gebruiker@bestemming
Stap 4: Matomo-bestanden en database overbrengen naar de nieuwe server
- Bestanden overzetten:
Pak de back-upbestanden uit in de juiste map op de nieuwe server (bijv./var/www/htmlof/pad/naar/bestemming).tar -xzvf matomo_backup.tar.gz -C /pad/naar/bestemming - Database herstellen:
Importeer de databasedump in de nieuwe MySQL-database:mysql -u db_gebruiker -p nieuwe_matomo_db < matomo_db_backup.sql
Stap 5: Configuratiebestanden op de nieuwe server bijwerken
- Databaseverbindingsgegevens bewerken:
Open op de nieuwe server de Matomoconfig/config.ini.phpbestand en werk de databaseverbindingsgegevens bij als ze anders zijn:iniKopiërenBewerken[database] host = "localhost" gebruikersnaam = "db_user" wachtwoord = "uw_wachtwoord" database = "new_matomo_db"Vervangendb_gebruiker,uw_wachtwoord, Ennew_matomo_dbmet de werkelijke kwalificaties. - Controleer bestandsrechten:
Zorg ervoor dat de bestands- en mapmachtigingen correct zijn, zodat Matomo goed kan functioneren:chown -R www-data:www-data /pad/naar/matomo chmod -R 755 /pad/naar/matomo
Stap 6: Definitieve serverconfiguratie
- Cron-taken:
Als u cronjobs voor Matomo gebruikt (bijvoorbeeld voor archivering), zorg er dan voor dat deze op de nieuwe server zijn ingesteld. Voorbeeld van een cronjob die elke 5 minuten wordt uitgevoerd:*/5 * * * * php /pad/naar/matomo/console core:archief - Test Matomo-installatie:
Open Matomo na de migratie in uw webbrowser en controleer of alles werkt, waaronder:- Trackinggegevens
- Rapporten
- Plugins
Stap 7: Verwijder SSH-sleuteltoegang van de nieuwe server
Nadat de migratie is voltooid en u hebt gecontroleerd of alles op de nieuwe server werkt, kunt u de SSH-sleutels van de nieuwe server verwijderen voor extra beveiliging.
- Verwijder de SSH-sleutel van de oude server uit de nieuwe server
geautoriseerde_sleutels:
Verwijder op de nieuwe server de openbare SSH-sleutel van de oude server uit de~/.ssh/geautoriseerde_sleutelsfile:nano ~/.ssh/geautoriseerde_sleutelsZoek en verwijder de regel met de openbare sleutel van de oude server. - Test het verwijderen van SSH-sleuteltoegang:
Probeer via SSH vanaf de oude server verbinding te maken met de nieuwe server om te bevestigen dat toegang niet langer is toegestaan:ssh gebruiker@bestemmingEr wordt u gevraagd om een wachtwoord in te voeren (ten teken dat de sleutel is verwijderd).
Stap 8: DNS en definitieve configuraties bijwerken
- DNS-records bijwerken:
Als Matomo wordt gehost onder een domein of subdomein, werk dan de DNS-records bij zodat ze verwijzen naar het IP-adres van de nieuwe server. - Verwijder de oude server:
Zodra u hebt gecontroleerd of alles werkt en de DNS is doorgegeven, kunt u de oude server buiten gebruik stellen.
Ga ook op de nieuwe server naar Instellingen > Diagnostiek om te controleren of alles goed is ingesteld en of Matomo beveiligingsproblemen detecteert die moeten worden opgelost.
Conclusie
U hebt uw Matomo-installatie succesvol van de ene server naar de andere gemigreerd, inclusief:
- Back-uppen en overzetten van bestanden en databases
- SSH-sleutelauthenticatie instellen
- De installatie testen op de nieuwe server
- De SSH-sleutel van de oude server verwijderen voor beveiliging
Als u deze stappen volgt, zou Matomo nu zonder problemen op uw nieuwe server moeten draaien!
Laatst bijgewerkt op 2 mei 2025
