Migration vtiger 5.0.2 à vtiger 5.0.3

Procédure de migration pour réussir un mise à jour de Vtiger 5.0.2 vers la version vtiger 5.0.3 (outil CRM open source)

  1. Installer une version propre de vtiger 5.0.3
  2. Faire une copie de la base de donnée de vtiger 5.0.2
  3. Verifier qu’il est possible de se connecter sur la version vtiger 5.0.3
  4. Modifier la configuration de vtiger 5.03
  5. Lancer la migration
  6. Déconnectez vous et reconnectez vous pour vérifier que tout fonctionne.

Détail d’une migration réussie

  1. Installer une version propre de vtiger 5.0.3
    Télécharger la version 5.0.3 ici et suivez la procédure d’installation adapté au type de contribution choisie.
    Sachez qu’il est possible d’installer une version simples sur un serveur déjà existant par exemple celui qui fait tourner votre version 5.0.2, je veux dire par simple que la contribution ne contient ni Apache ni Mysql.
  2. Faire une copie de la base de donnée de vtiger 5.02
    Utiliser phpMyadmin qui est en général installé sur tout les hébergement et serveur web de type LAMP ou WAMP.
    Je penses que vous connaissez tous PhpMyadmin mais vous pouvez effectuer cette sauvegarde avec n’importe quel logiciel de gestion de MySql.
  3. Vérifier qu’il est possible de se connecter sur la version vtiger 5.03
    Connectez vous sur la version vtiger 5.0.3 fraichement installée et rester connecté avant d’effectuer les deux étapes suivantes (4 et 5).
    Je ne donnerais aucun exemple d’adresse dans la mesure ou vous devez aboutir sur cet écran à la fin de la procédure d’installation.
  4. Modifier la configuration de vtiger 5.03
    Pour utiliser la database 5.02 que nous avons sauvegardé a l’étape 2 il faut éditer le fichier config.inc.php, se trouvant à la racine de votre répertoire d’installation de vtiger5.03.
  5. Lancer la migration
    Choisissez la rubrique configuration dans le menu du haut de vtiger puis chercher la zone Autres réglages (outil Migration)
    outil migration vtiger
    Vous devriez arrivez sur cet écran
    ecran de configuration pour la migration de vtiger
    Lancer la « moulinette » en cliquant le bouton Migrer et patientez quelques instants ne tenez pas compte des éventuelles alertes sur les reqêtes non abouties si elle concerne des alter table (cf paragraphe ci-dessous).
  6. Déconnectez vous et reconnectez vous pour vérifier que tout fonctionne.
    Pensez à vérifier que vous n’êtes pas sujet au problème de compatibilité PHP4 en éditant un contact ou un compte, voir en créant une nouvelle facture.
    Si vous êtes victime de ce problème d’incompatibilité alors il convient d’effectuer la modification décrite dans le dernier paragraphe de cet article.

Problème que vous pourrez rencontrer

  1. lors de la migration de la database :
    Il est possible que vous obteniez les méssages suivant après la migration, mais il semblerait que ce soit sans conséquences trop importantes.

    ALTER TABLE vtiger_parenttabrel ADD CONSTRAINT fk_2_vtiger_parenttabrel FOREIGN KEY (parenttabid) REFERENCES vtiger_parenttab(parenttabid) ON DELETE CASCADE;
    ALTER TABLE vtiger_leadgrouprelation ADD CONSTRAINT fk_1_vtiger_leadgrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_potentialgrouprelation ADD CONSTRAINT fk_1_vtiger_potentialgrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_ticketgrouprelation ADD CONSTRAINT fk_1_vtiger_ticketgrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_sogrouprelation ADD CONSTRAINT fk_1_vtiger_sogrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_quotegrouprelation ADD CONSTRAINT fk_1_vtiger_quotegrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_pogrouprelation ADD CONSTRAINT fk_1_vtiger_pogrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;
    ALTER TABLE vtiger_invoicegrouprelation ADD CONSTRAINT fk_1_vtiger_invoicegrouprelation FOREIGN KEY (groupname) REFERENCES vtiger_groups(groupname) ON UPDATE CASCADE;

  2. lors de l’utilisation de l’application :
    Si il vous est impossible de sauvegarder après création ou modification un contact, un compte, une facture, un devis ….
    Vérifier la version de PHP que vous utilisez.
    Si vous utilisez PHP4 il convient d’éffectuer une modification pour rendre compatible Vtiger5.03 avec PHP4 car depuis cette version Vtiger est compatible PHP5 uniquement.
    Donc editer le fichier include/utils/CommonUtils.php et chercher la fonction setObjectValuesFromRequest($focus) ligne 1657 il suffit de modifier la déclaration de la fonction en ajoutant un & ce qui donne function setObjectValuesFromRequest(&$focus) voir l’article sur le forum officiel de vtiger http://forums.vtiger.com/viewtopic.php?t=14909&postdays=0&postorder=asc&start=30