Comment mettre à jour PhpGedView d'une version 4.0.2 ou 4.1.x vers une version supérieure

Cet article vous explique comment effectuer une mise à jour d'une version PhpGedView v4.0.x ou 4.1.y vers une version PhpGedView v4.1.x.

Mise à jour de 4.1 vers 4.1.x

Mettre à jour PhpGedView d'une version 4.1 vers une version 4.1.4 ou toute autre version 4.1.x n'est pas difficile, mais cette opération ne consiste pas uniquement à remplacer les fichiers présents sur le serveur par de nouveaux fichiers.

Voici les différentes étapes à suivre pour réaliser cette migration:

1. Pour effectuer une mise à jour d'une version 4.1 vers une version 4.1.4 ou toute autre version 4.1.x, remplacez les fichiers présents sur votre serveur par les fichiers de la nouvelle version, en écrasant les fichiers présents sur votre serveur.
2. N'oubliez pas de supprimer également tous les fichiers qui sont présents dans le répertoire PhpGedView/index/cache, car ces fichiers sont faits pour fonctionner avec votre version actuelle de PhpGedView, pas avec une nouvelle version. Pour supprimer les fichiers présents dans le répertoire PhpGedView/index/cache, il vous suffit de vous rendre sur la page "Mon Portail --> Administration --> Nettoyer le répertoire «index»", puis de cocher la case "cache" qui apparaît sur la page "Nettoyer le répertoire «index»". Vous pouvez également détruire manuellement ces fichiers dans votre répertoire "index" en utilisant votre logiciel FTP.

Mise à jour de 4.0 vers 4.1.x

Les étapes suivantes supposent que vous êtes familier avec l'installation de PhpGedView et que vous avez déjà installé ce logiciel avec succès.

1. Transférez les fichiers de la nouvelle version 4.1.x sur votre serveur en écrasant les fichiers existants par les nouveaux fichiers. Ne remplacez pas le fichier config.php ni le répertoire index !.
2. Afin de créer les données nécessaires à la nouvelle version, vous devez réimporter votre GEDCOM.

• Procédure pour mettre à jour votre gedcom

Le fichier doit comporter le même nom que le fichier déjà en place (attention à la casse - Maj/Min ). Il est inutile de supprimer l'ancien fichier (sauf si le nom est différent)

• • Remplacer l'ancien fichier par le nouveau (par FTP), attention au nom
  • Réimporter le fichier ==> Admin->Manage GEDCOMs->Import GEDCOM
  • Le système détecte que le fichier existe déjà, et vous demande si vous voulez le supprimer, répondez OUI
  • Le système mouline un moment plus ou moins long selon la taille de votre fichier, a titre indicatif, un fichier de près de 8 Mo comportant 26500 individus demande 560 secondes. Si le système s'arrête en cours de chargement suite à un délai trop court, faire continuer, le chargement reprend a l'endroit où il s'était arrêté.

Dans le cas ou le bouton continuer n'apparait pas, recommencer l'opération avec un délai plus long (le message dit plus court, c'est une erreur)

1. Vous pouvez maintenant utiliser votre site mis à jour.
2. Si vous utilisez un thème que vous avez vous-même modifié, vous devrez adpater votre thème avec les nouvelles feuilles de styles et les variables de la nouvelle version. Un excellent outil peut vous aider à fusionner des thèmes: il s'agit de l'outil WinMerge que vous pouvez télécharger ici: http://winmerge.sourceforge.net/

Note pour les utilisateurs de SQLite: Malheureusement SQLite ne supporte pas la commande SQL ALTER TABLE. Cela signifie que vous devez en premier lieu supprimer les tables existantes puis les recréer. Il est fortement recommandé de faire fonctionner la sauvegarde avant de la mettre à jour.

La version 4.x n'offre plus de support aux fichiers index, comme çà l'était avec les versions 3.x. Si vous ne disposez pas d'un environnement PHP 5/SQLite ou si vous n'avez pas de compte de base de données, alirs vous ne devez pas mettre à jour votre logiciel vers la version PhpGedView 4.x. Les releases de maintenance continueront pour la version the 3.3.x jusqu'à ce que PHP 4 ne soit plus supporté.

Cas particulier des sites pour lesquels aucune modification de la base de données n'a été faite en ligne ou pour les sites dont les modifications ont été réalisées en ligne mais dont leur base de données et leurs fichiers GEDCOM sont synchronisés

Ces instructions concernent les sites pour lesquels aucune modification de la base de données n'a été faite en ligne ou pour les sites dont les modifications ont été réalisées en ligne mais dont leur base de données et leurs fichiers GEDCOM sont synchronisés. Si vous n'avez pas synchronisé votre base de données et vos fichiers GEDCOM, exportez une copie de votre base de données.

Préparation d'une copie d'installation de la dernière version de phpGedView sur votre ordinateur personnel

1. Réalisez une sauvegarde (backup) de votre base de données SQL. Vous pouvez avoir besoin de faire appel à l'aide de votre hébergeur web pour réaliser cette opération.
2. Faites une sauvegarde de votre répertoire /index, de votre répertoire /media et de votre fichier "config.php".
3. Si vous avez effectué des modifications sur vos fichiers de langues (ces fichiers se nomment "languages/extra.xx.php"), faites également une sauvegarde de ces fichiers.
4. Faites une sauvegarde de toutes les modifications ou ajouts que vous avez effectuées sur les thèmes.
5. Si vous avez de la place sur votre serveur, renommez votre installation existante et laissez la en place momentanément. Cela vous servira de sauvegarde supplémentaire.
6. Téléchargez une copie de la dernière version de PhpGedView et décompressez-la sur votre ordinateur personnel.
7. Remplacez les fichiers/répertoires suivants que vous venez de récupérer de la dernière version de phpGedView, par ceux que vous avez sauvegardés précédemment sur votre ordinateur:

• fichier "config.php"
• drépertoire "media"
• répertoire "index"
• modifications apportées aux thèmes. Ne copiez pas en intégralité la sauvegarde de votre répertoire "themes", parce que les dernières versions de PhpGedView peuvent contenir des mises à jour très importantes pour les thèmes.
• fichier "languages/extra.xx.php" - Si vous avez modifié les fichiers de langues, ajoutez-les. Ne copiez pas en intégralité la sauvegarde de votre répertoire "languages" parce que les dernières versions de PhpGedView peuvent contenir des mises à jour très importantes.
• Si vous n'envisagez pas d'utiliser tous les modules disponibles, vous pouvez supprimer les répertoires correspondant aux modules que vous ne souhaitez pas utiliser.

Installation de la copie d'installation de la dernière version de phpGedView sur votre serveur

Cette étape préparatoire vous a donné une copie complète (à l'exception de la base de données) de l'installation de phpGedView sur votre ordinateur personnel. Suivez maintenant les étapes suivantes pour installer cette copie sur votre serveur:

1. Copiez sur votre serveur, l'intégralité du contenu du répertoire de votre ordinateur personnel qui contient la dernière version de phpGedView que vous avez préparée précédemment.
2. Assurez-vous que les attributs du répertoire "index" et des fichiers qu'il contient, sont bien paramétrés à 0777 (lire/écrire/modifier).
3. Si vous avez l'intention d'utiliser PhpGedView pour transférer des fichiers media ou pour créer des vignettes à partir de fichiers media que vous avez transféré sur votre serveur sans utiliser phpGedView, vous devez paramétrer les attributs du répertoire "media" et des sous répertoires et fichiers qu'il contient à 0777 (lire/écrire/modifier). Lisez attentivement cet article Media_Firewall pour connaître les instructions qui vous permettront de relocaliser votre répertoire "media" à l'extérieur de l'espace pouvant être adressé par le web.
4. Si vous avez besoin de reconfigurer entièrement votre site PhpGedView ou si vous avez besoin de modifier des informations relatives à la connexion à votre base de données, vous devez paramétrer les attributs du fichier "config.php" à 0777 (lire/écrire/modifier). Une fois que vous terminé vos modifications sur ce fichier, vous pouvez paramétrer ses attributs à "lire" uniquement.
5. Puisque le programme de phpGedView a été modifié, vous devez supprimer le fichier de cache "Evénements à venir". Le nom de ce fichier se termine par "_upcoming.php" et se trouve dans votre répertoire "index".
6. A partir de votre navigateur Internet, rendez-vous sur votre site PhpGedView et connectez-vous en tant qu'administrateur.
7. Ré-importez votre GEDCOM (un nouveau transfert de ce fichier GEDCOM sur votre serveur n'est pas nécessaire sauf si vous avez modifié hors-ligne ce fichier ou si vous n'avez pas utilisé la fonction de synchronistaion).

• Laissez le soin à PhpGedView d'effectuer toutes les corrections qu'il estimera nécessaires.
• Laissez PhpGedView nettoyer le contenu de votre base de données. PhpGedView ne mettra à jour que les tables qui concernent le fichier GEDCOM.
• PhpGedView peut modifier la structure d'autres tables, telles que celles relatives aux utilisateurs (Users), aux favoris (Favorites), aux nouvelles (News), ainsi qu'aux blocs (Blocks) afin de respecter les exigences de la nouvelle version, mais le contenu de ces tables retsera intact.