Handleiding: Vtiger CRM Open Source Updaten (Migratie Gids)

In deze technische handleiding leer je hoe je Vtiger CRM Open Source veilig kunt updaten naar een nieuwere versie. Het bijwerken van Vtiger is cruciaal voor beveiliging, bugfixes en compatibiliteit met moderne PHP-omgevingen.

1. Voorbereiding en Systeemvereisten

Voordat de migratie start, moet de serveromgeving voldoen aan de eisen van de doelversie.

  • Maak een Volledige Backup:

    • Database: Exporteer de MySQL-database (bijv. via mysqldump -u [user] -p [db_name] > backup.sql).

    • Bestandssysteem: Maak een volledige kopie van de Vtiger installatiemap.

  • Controleer PHP-versie: Vtiger 8.x en hoger vereisen vaak PHP 8.1 of 8.2. Controleer ook of de benodigde extensies (php-imap, php-curl, php-xml, php-mbstring) actief zijn.

  • Staging: Voer de update altijd eerst uit op een testomgeving (kopie van productie).

2. Stap-voor-stap Migratieproces

Stap 1: Download de juiste Migration Patch

Vtiger maakt gebruik van specifieke patches om van de ene versie naar de andere te gaan.

Stap 2: Patch-bestanden installeren

  1. Pak het .zip bestand uit op je lokale machine.

  2. Upload de inhoud (inclusief de map /migrate) naar de root-directory van je Vtiger installatie via FTP, SFTP of SSH.

  3. Overschrijf bestaande bestanden indien hierom gevraagd wordt.

Stap 3: Bestandsrechten instellen (Linux)

De webserver of hosting user moet schrijfrechten hebben op de nieuwe bestanden. Voer het volgende commando uit of pas www-data:www-data aan naar de directadmin username dus  chown -R DAuser:DAuser /pad/naar/vtigercrm

Bash

 
chown -R www-data:www-data /pad/naar/vtigercrm
chmod -R 755 /pad/naar/vtigercrm

Stap 4: De Grafische Migratie-Wizard uitvoeren

De database-updates worden uitgevoerd via de browser:

  1. Navigeer naar: https://jouw-crm-domein.nl/migrate/

  2. Log in met de gegevens van de Admin-gebruiker.

  3. Volg de instructies op het scherm en klik op Start Migration.

Stap 5: Post-Migratie Opschoning

Na een succesvolle melding van de wizard:

  • Beveiliging: Verwijder de map /migrate onmiddellijk van de server.

  • Cache legen: Verwijder alle bestanden in de mappen test/templates_c en test/cache.

  • Frontend: Vernieuw de browsercache met Ctrl + F5.

3. Problemen Oplossen (Troubleshooting)

Symptoom Oorzaak Oplossing
White Screen of Death (WSoD) PHP Error / Ontbrekende extensie Check logs/vtigercrm.log en de Apache/Nginx error logs.
Script Timeout max_execution_time te laag Verhoog in php.ini: max_execution_time = 600.
Geheugenlimiet bereikt memory_limit te laag Verhoog in php.ini: memory_limit = 512M.
Database Access Denied Onvoldoende MySQL rechten Zorg dat de DB-user ALTER, CREATE en DROP rechten heeft.

0 reacties

Een reactie versturen

Je e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *