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.

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. Copy the entire contents of the new local PC PhpGedView directory to your server's PGV operating directory. If necessary, create that directory first.
2. Be sure to set full read/write/modify permission (0777) on the "index" folder and all its contents.
3. If you intend to use PGV to upload media files or to create thumbnails from media files that have been uploaded outside PGV, you must set full read/write/modify (0777) permission on the "media" folder, its contents, and all its sub-folders and their contents. Please see the article on the Media_Firewall for instructions on how to relocate the Media folder to be outside the web-addressable space.
4. If you need to reconfigure the entire PGV site or change any of the database connection information, you must set full read/write/modify (0777) permission on the file "config.php". After your configuration changes have been stored, you can set this file to read-only.
5. Some of the internal structures have changed, so you must delete the Upcoming Events cache file. This file's name ends with "_upcoming.php" and is housed in your "index" folder.
6. Via your web browser, navigate to your PhpGedView installation (localhost or internet domain or IP number) and log in as Administrator.
7. Immediately re-import your GEDCOM (a fresh upload isn't necessary unless you modified the GEDCOM offline or did not use the sync function).

• Let PGV make whatever corrections it deems necessary.
• Be sure to let PGV erase existing database contents. PGV will only erase and repopulate the tables relevant to the GEDCOM.
• PGV might change the structure of certain other tables, including Users, Favorites, News, and Blocks to suit the requirements of the new version, but the contents will remain intact.

Upgrading 4.0 to 4.1.x

Use the following steps to upgrade to v4.1. These steps assume that you are familiar with PhpGedView and have successfully installed it before.

1. Upload the new 4.1 files to your server replacing the old files with the new files. Do not replace the config.php file or the index directory.
2. In order to create the data required for the new version, you will have to re-import your GEDCOM.
3. You can now use your upgraded site.
4. If you are using a customized theme you will need to update your theme with new stylesheets and variables. An excellent tool that can help you to merge themes is the WinMerge project http://winmerge.sourceforge.net/

Note to SQLite users: Unfortunately SQLite does not support the ALTER TABLE
SQL command.  This means that we must first drop the tables and recrate
them.  It is highly reccomended that you run the backup before upgrading.

Version 4.x no longer includes support for index files. If you do not have PHP 5 with built-in SQLite support or a database account then you should not upgrade to PhpGedView 4.x. Maintenance releases will continue for the 3.3.x version until PHP 4 is no longer supported.