Mise à jour vers une nouvelle version
From Textbook
Vue d'ensemble
Cette section décrit comment mettre à jour manuellement votre installation de Textpattern existante d'une ancienne vers la dernière version disponible (c.a.d., rc1). Si vous avez déjà la dernière version rc3/1 installée et que vous voulez la mettre à jour vers la dernière révision, suivez les instructions pour Updating to a New Revision. Veuillez noter que cette section ne couvre pas Subversion (SVN) comme méthode de mise à jour, recommandée aux utilisateurs expérimentés ou à ceux ayant les connaissances techniques requises pour son utilisation. Si vous êtes intéressés par l'utilisation de SVN plutôt que par la mise à jour manuelle, consultez les différentes options disponibles pour votre plate-forme au Chapitre 5: Advanced Topics.
En résumé vous allez sauvegarder votre installation actuelle (sauvegarder votre base de donnée et les fichiers installés sur votre serveur), écraser votre installation existante avec la nouvelle version, modifier le nouveau fichier config.php avec les informations de l'ancien fichier config.php et enfin faire les modifications nécessaires dans l'onglet préférences.
Le processus
Etape 1: Télécharger la nouvelle version de Textpattern
Pour commencer vous avez besoin de télécharger sur votre machine, la nouvelle version compressée de textpattern, rc3/1, sur textpattern.com/download. Décompressez la dans un dossier de votre machine. Peu importe le nom de ce dossier pourvu qu'il ait un sens pour vous, "txp_rc3-1" par exemple. A présent laissez ce dossier, vous y reviendrez plus tard. Vous allez vous occuper des deux étapes suivantes.
Etape 2: Sauvegarder vos anciennes données de Textpattern (par précaution)
2.a: Sauvegarde de la base de donnée MySQL
Tout d'abord faites une copie de sauvegarde de votre base de donnée MySQL. Pour ce faire vous devez vous identifier auprès de votre hébergeur. Accédez au panneau d'administration, en général MyPHPadmin pour la plupart des utilisateurs. Utilisez ce panneau d'administration pour effectuer une copie de votre base de donnée, qui aura le même nom que cette base suivi d'une extension ".sql". Afin de ne pas vous disperser, sauvegardez la dans le dossier créé à l'étape 1.
2.b: Sauvegarde de vos fichiers Textpattern existants
Deuxièmement, sauvegardez les fichiers de votre installation existante de Textpattern. La manière la plus simple consiste à utiliser le protocole de transfert fichiers File Transfer Protocol (FTP) à l'aide d'un logiciel client de votre choix. Ouvrez votre client FTP, authentifiez-vous auprès de votre serveur afin d'accéder aux fichiers Textpattern existants. Créez un dossier et nommez le "textpattern-ancien". Copiez y les fichiers de Textpattern présents, existants sur votre serveur ( veillez à conserver la structure de fichiers à l'identique).
C'est après avoir effectué cette copie de sauvegarde de vos anciens fichiers de Textpattern que vous allez, dès l'étape suivante, effectuer les vrais changements . Si les choses ne se passent pas comme prévu vous pourrez toujours utiliser ces sauvegardes pour revenir à votre ancienne installation. Si le cas se présente, vous n'aurez qu'a copier les fichiers précédemment sauvegardés dans le dossier "textpattern-ancien" et les remettre à leur place initiale. Vous disposez également d'une sauvegarde de votre base de donnée en cas de complication.
Etape 3: Installation des nouveaux fichiers de Textpattern
Ouvrez votre client FTP, lancez une connexion et parcourez votre disque local jusqu'au dossier créé à l'étape 1 contenant les nouveaux fichiers de la version décompressée de Textpattern. A l'aide de votre client FTP copiez ces nouveaux fichiers à l'emplacement original sur le serveur et écrasez les anciens fichiers installés.
Note: Il est très important que vous soyez sûr que les deux fichiers index.php et .htaccess aient bien été transférés. En général il n'y pas de problème, mais certains clients FTP n'affichent pas le fichier .htaccess. Afin de bien vérifier que les fichiers ont été transférés, comparez les fichiers sur votre serveur avec ceux situés sur votre disque local. Si leur contenu est identique alors vous n'avez pas à vous en préoccuper. Si les fichiers sont différents, procédez alors de la manière suivante: ouvrez le fichiers .htaccess situé dans les fichiers décompressés de votre dossier précédemment créé sur votre disque local, copiez son contenu et utilisez le pour remplacer le contenu du fichier .htaccess présent sur votre serveur ( n'effectuez cette opération qu'après avoir écrasé ces fichiers comme indiqué auparavant ). De cette manière vous serez sûr d'avoir le bon fichier .htaccess (ainsi que les règles nécessaires à mod_rewrite) pour votre nouvelle installation. Répétez cette opération également pour le fichier index.php si son contenu vous parait ne pas avoir été mis à jour.
Etape 4: Mettre à jour le fichier de Config
L'ancien et le nouveau fichier config.php sont quasiment identiques: l'unique différence est que l'ancien fichier contient deux variables qui ne sont plus utilisées dans le nouveau fichier. Cette étape inclut la copie de l'ancien fichier et la suppression de ces lignes inutiles.
1. Ouvrez le nouveau fichier et effacez complètement son contenu.
2. Ouvrez l'ancien fichier et copiez son contenu. Fermez ce fichier.
3. Collez la copie dans le nouveau fichier.
4. Repérez les lignes commençant par $txpcfg['doc_root'] et $txpcfg['secret_word'] et supprimez les.
5. Sauvegardez et fermez le fichier.
Etape 5: Vérifier la mise à jour et réglage des détails
A ce point vous devriez être en mesure d'ouvrir votre navigateur internet et d'accéder à la zone d'admin de votre site. Vous aurez peut-être à vous identifier. Dans ce cas vous devriez pouvoir utilisez vos anciens identifiants . Si vous n'arriver pas à vous identifier c'est qu'il y a sûrement quelque chose d'incorrect dans le fichier config.php. Reportez-vous alors à l'étape précédente, vérifiez que l'information contenue dans le nouveau fichier config.php corresponde bien à celle contenue dans l'ancien fichier config.php et réessayez.
Le simple fait d'accéder à l'administration de votre site, que vous ayez / n'ayez pas à vous identifier, met automatiquement à jour votre site à l'aide de _update.php, fichier inclut dans la version 1.0rc3. Note: vous n'avez pas à exécuter manuellement les fichiers setup.php ou _update.php . N'essayez pas, cela ne fonctionnera pas. Encore une fois, Textpattern calibre automatiquement votre mise à jour dès que vous accédez à n'importe quelle page de votre zone d'administration.
Une fois authentifié avec succès à votre zone d'administration, rendez-vous à l'onglet Preferences Subtab (vous auriez dû y accéder par défaut) et assurez vous que vos Preferences et Comments soient bien configurés comme vous le souhaitez. La première chose à noter, si vous effectuez une la mise à jour d'une version antérieure à la 1.0rc3, c'est qu'il n'y a plus de champ "Subdirectory" dans la zone de Preferences. Vous indiquez simplement l'adresse de votre site dans le champ "Site URL".
Rendez vous ensuite à un autre panneau de la zone d'admin, nouveau également dans la version v 1.0, l'onglet Diagnostics Subtab. Les éventuels problèmes diagnostiqués sont indiqués en texte rouge.
A partir de ce point vous avez effectué la mise à jour de votre installation avec succès. Vous pouvez dès lors supprimer les fichiers inutiles.
Supprimer les fichiers inutiles
Certains fichiers devraient être supprimés de votre installation, une fois avoir installé avec succès, ou effectué la mise à jour de Textpattern sur votre serveur. Une discussion sur ces fichiers est fournie dans Post Installation, Upgrading, Updating Suggestions.
