PDA

Voir la version complète : Mise à jour de vBulletin 3.0.x


Pitchoune
07/07/2005, 10h36
De temps en temps, il est nécessaire de mettre à jour votre installation vBulletin à la dernière version, aussi pour acquérir de nouvelles fonctions ou pour corriger les nouveaux bugs découverts dans PHP, MySQL ou vBulletin lui-même.

Vous pouvez mettre à jour à la dernière version de vBulletin 3 aux versions suivantes :

N'importe quel version de vBulletin 3.5, de vBulletin 3.0.0 à la version actuelle.
N'importe quel version de vBulletin 3, de vBulletin 3 Beta 3 à la version actuelle.
N'importe quel version de vBulletin 2 depuis vBulletin 2.2.9 ou plus. Si votre version de vBulletin est plus ancienne que vBulletin 2.2.9, vous devez mettre à jour à la version vBulletin 2.3.8 avant de pouvoir passer à vBulletin 3.
Le processus de mise à jour est différent selon la version de vBulletin installée actuellement sur votre serveur web. Les sites utilisant vBulletin 2 doivent suivre les instructions légèrement différentes des sites utilisant déjà vBulletin 3 et mettre à jour à la dernière version.

Quand vous mettez à jour, la première étape est toujours la même, est que vous devez vous identifiez dans l'Espace Membres vBulletin et télécharger la dernière archive vBulletin disponible, comme décrite dans les instructions d'installation (étape 1) (http://forum.vbulletin-fr.org/showthread.php?t=8671).

Attention :
Nous recommandons très fortement de sauvegarder votre base de données avant toute mise à jour.

Etape 1 : Préparer les fichiers vBulletin pour l'upload

Après avoir téléchargé avec succès l'archive vBulletin sur votre ordinateur, vous avez besoin de préparer les scripts à être uploadés sur votre serveur web.
La première chose à faire est de décompresser l'archive avec les fichiers qui le constitue. Si vous avez téléchargé l'archive .zip et que vous êtes sous une version récente de Windows®, tous les outils dont vous avez besoin sont présents en partie dans Windows®. Cette section est décrite avec l'archive en .zip et que vous êtes sous Windows XP.

Pour extraire les fichiers de l'archive, ouvrez le répertoire sur votre ordinateur où vous avez sauvegardé l'archive vBulletin et faites un clic-droit sur son icône, puis choisissez Extraire tout ... du menu.

http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_files.png

Ceci ouvrira un assistant qui vous guidera à travers le processus de décompression. Acceptez les paramètres par défaut suggérés et le système décompressera les fichiers de l'archive.

http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_progress.png

Quand la progression de la décompression est terminée, vous vous apercevrez que le processus a crée un nouveau répertoire appelé vBulletin_versionnum_licensenum (où versionnum est le numéro de la version de l'archive téléchargé, et licensenum est le numéro de licence vBulletin).

A l'intérieur de ce répertoire, vous trouverez un autre répertoire appelé versionnum.licensenum, et dedans se trouvera une collection de fichiers readme et un répertoire appelé upload. Ce répertoire contient les fichiers vBulletin qui doivent être uploadés sur votre serveur web.

Vous devez maintenant renommer le répertoire « upload » par le nom du dossier utilisé par votre forum sur votre serveur web actuellement. Dans cet exemple, le répertoire contenant les fichiers vBulletin est appelé « forums ».

http://forum.vbulletin-fr.org/tutorial/preparefiles/rename_upload.png

Note :
Si vous avez déjà une installation de vBulletin utilisée sur votre serveur web, vous devez supprimer le fichier install.php du répertoire install avant de mettre à jour les fichiers.

Etape 2 : Mise à jour des scripts de vBulletin sur votre serveur web

Après avoir téléchargé la dernière version de l'archive vBulletin et de l'avoir décompressé dans un répertoire, vous devez maintenant préparer votre serveur web à accepter les pages mises à jour.

Il y a deux façons de le faire.

La première méthode consiste à écraser tous les fichiers précédemment uploadés sur votre serveur web, tandis que la seconde méthode consiste à supprimer tous les anciens fichiers et répertoires, puis uploader les nouveaux fichiers. Dans ce tutorial, la première méthode sera utilisée.

Après avoir renommé le répertoire upload comme spécifié dans l'étape précédente (http://forum.vbulletin-fr.org/tutorial.php?tutoid=18), vous devez lancer votre client FTP habituel. Dans cet exemple, SmartFTP (http://www.smartftp.com/) sera utilisé.

Connectez-vous à votre serveur web avec d'un côté les nouveaux fichiers vBulletin dans le panneau local et les anciens fichiers dans le panneau du serveur web. Une fois connecté, déplacez le répertoire forums dans le dossier parent de l'installation de vBulletin sur le serveur web comme indiqué ici :

http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_upgrade.png

Vous allez avoir une confirmation de remplacement des fichiers. Vous devez confirmer ce remplacement en indiquant à votre client FTP de remplacer les fichiers. Si il vous est proposé de remplacer tous les fichiers sans redemander par la suite, utilisez cette option.

http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_overwrite.png

La plupart des clients FTP s'occupe des méthodes de transferts de fichiers automatiquement, mais si pour une raison quelconque, votre application ne le fait pas, vous devriez noter ce qui suit :
Tous les fichiers textes doivent être transférés en mode ASCII
Tous les fichiers contenant du texte de l'archive vBulletin doivent être transférés en mode ASCII.

Les types de fichiers textes que vous trouverez dans vBulletin sont : .html, .php, .js, .xml, .css.
Tous les fichiers autres que des fichiers textes doivent être transférés en mode Binaire
Les fichiers restants, en majorité des images, doivent être transférés sur votre serveur web en mode Binaire.

Les types de fichiers binaires utilisés dans vBulletin sont : .gif, .png, .jpg, .ico.

Attention :

Il est extrêmement important d'uploader tous les fichiers de la dernière version de vBulletin, incluant la totalité du répertoire install.

Si il y a un échec lors de l'upload des fichiers, le script de mise à jour peut ne pas terminer avec succès le processus de mise à jour.

Etape 3 : Mise à jour depuis vBulletin 2

Note :
Cette étape s'adresse uniquement pour une mise à jour depuis vBulletin 2 à vBulletin 3. Si vous utilisez déjà vBulletin 3, vous pouvez sauter cette étape.

Après avoir uploadé tous les fichiers vBulletin avec succès sur votre serveur web, vous devez noter les valeurs du fichier admin/config.php de vBulletin 2 et les appliquer sur le nouveau fichier includes/config.php.new de vBulletin 3 décrit ici (étape 3).

Vous avez besoin de faire une petite maintenance sur les fichiers stockés sur votre serveur web afin de retirer les fichiers et dossiers de vBulletin 2 que vBulletin 3 n'utilise pas.

Depuis le répertoire « forums » de votre serveur web, vous devez supprimer les fichiers et répertoires suivants :

Le répertoire admin
Le répertoire mod
Le fichier avatar.php
Le fichier cp.css
Le fichier member2.php
Le fichier vbcode.js
Le fichier vbcode_language.js
Tous les fichiers .gif à la racine du répertoire images

http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_delete.png

Après avoir terminé le processus de suppression, vous pouvez lancer le script de mise à jour pour passer de vBulletin 2 à vBulletin 3.

Veuillez noter qu'avec la taille de votre base de données et la vitesse de votre serveur web, la phase de conversion de la base de données vBulletin 2 en une base de données vBulletin 3 peut prendre du temps. Une base de données avec un million de messages peut prendre quelques heures pour être mis à jour.

Etape 4 : Lancer le script de mise à jour vBulletin

Attention :
Certains plug-ins de navigateurs, comme la célèbre Barre Google, peuvent provoquer des perturbations durant l'exécution d'un script d'installation ou de mise à jour vBulletin. Il est recommandé de désactiver tous les plug-ins des navigateurs pendant l'exécution d'un script d'installation ou de mise à jour de vBulletin.

Avec les nouveaux fichiers vBulletin sur votre serveur web, vous pouvez maintenant lancer le script de mise à jour. Pour faire ceci, allez à la page http://www.exemple.com/forums/install/upgrade.php en remplaçant www.exemple.com/forums (http://www.exemple.com/forums) avec l'adresse URL correcte de votre installation de vBulletin.

La première chose que vous pouvez voir du script de mise à jour est une demande d'identification, vous demandant d'entrer votre Customer Number. Ceci sert à éviter que d'autres utilisateurs puissent utiliser le script de mise à jour accidentellement. Vous avez uniquement besoin de votre Customer Number.

Note :
Votre Customer Number est la valeur composé de chiffres et de lettres utilisé pour vous connecter à l'Espace Membres vBulletin. Vous devez entrer votre Customer Number avec précaution afin d'éviter des erreurs. Notez que votre Customer Number n'est pas le même que votre numéro de licence vBulletin.

http://forum.vbulletin-fr.org/tutorial/runinstaller/upgrade_login.png

Quand vous avez entré votre Customer Number, cliquez sur le bouton [Enter Upgrade System] et vous devriez être amené à la première étape du script de mise à jour. Si, après avoir cliqué sur le bouton [Enter Upgrade System], vous revenez sur la même page d'identification, c'est que vous avez mal entré votre Customer Number. Vérifiez les fautes et retentez.

La première page du script de mise à jour vous accueillera et vous donnera quelques détails.

Après avoir lu les informations de la page d'accueil de l'installation, vous pouvez cliquer sur le large bouton [Next Step] en bas à droite de la fenêtre pour aller à la prochaine étape de la mise à jour.

A chaque étape terminée, un bouton [Next Step] apparaîtra en bas de chaque page. Quand le bouton apparaît, l'étape a été réalisée avec succès et il vous reste à cliquer sur ce bouton pour continuer.

Attention :
Actualisez aucune page des scripts de mise à jour. Actualiser les pages causerait des problèmes d'exécution des scripts qui appliquerait les changements à deux reprises, ce qui causerait des dommages dans la base de données.

Il existe un script de mise à jour différent pour chaque version de vBulletin. Par exemple, si vous utilisez vBulletin 3.0.0 Release Candidate 4, le système va d'abord mettre à jour votre base de données pour vBulletin 3.0.0, puis pour vBulletin 3.0.1. A la fin de chaque script de mise à jour, le système recherchera les scripts additionnels qu'il a besoin pour pouvoir continuer les mises à jour.

Quand tous les scripts de mise à jour ont été exécutés, vous serez redirigé automatiquement dans le Logiciel d'Administration, vous demandant de vous identifier.

Etape 5 : Vérification des templates mis à jour

Quand une nouvelle version de vBulletin est disponible, il est normal que des templates soient mis à jour afin d'accomoder de nouvelles propriétés ou des patchs pour d'éventuels bugs.

Si vous avez personnalisé aucun template, ceci ne vous concerne pas, mais si vous avez personnalisé certains templates, il y a quelques étapes à suivre après avoir mis à jour votre forum.

Note :
Quand vous mettez à jour votre forum, une des étapes consiste à importer la nouvelle version du style par défaut.

Tous les templates que vous n'avez pas personnalisé sont automatiquement mis à jour afin d'utiliser la dernière version.

Cependant, tous les templates que vous avez personalisés ne seront pas modifiés ou remplacés par l'importation du dernier style, d'où l'intérêt d'exécuter les étapes suivantes.

Premièrement, vous devriez aller dans « Style & Templates > Rechercher les templates mis à jour » afin de visualiser quels templates personnalisés ont été modifiés entre les 2 versions utilisés du forum.

Deuxièmement, si vous apercevez que des templates personnalisés ont la version par défaut mis à jour, vous avez trois possibilités. Vous pouvez soit :
Ne rien faire et espérer que le template personnalisé fonctionnera toujours avec la nouvelle version de vBulletin. Ceci n'est parfois pas un soucis, mais la plupart du temps, une variable peut avoir été renommé ou un autre changement similaire a pu être appliqué, ce qui rend le template non-fonctionnel.
Cliquer sur le lien [Réinitialiser] pour chaque template, retirer vos personnalisations pour s'assurer que le template soit pleinement compatible avec la nouvelle version de vBulletin.
Cliquer sur le lien [Modifier le template] pour chaque template, et de comparer le contenu de votre template personnalisé avec la version disponible en cliquant sur le bouton [Afficher par défaut] afin de mettre à jour manuellement le template pour qu'il reflète les chagements vus dans le template par défaut.A la sortie d'une nouvelle version de vBulletin, l'annonce de sortie du forum Annonces (http://www.vbulletin.com/forum/forumdisplay?f=1) de vBulletin.com contient habituellement la liste des templates mis à jour.

La liste peut parfois vous indiquer si les changements à effectuer dans chaque template sont purement cosmétique ou pas, auquel vous n'avez pas besoin de suivre les étapes précédentes pour chaque template, ou si les changements demande à être reinitialisé ou modifié manuellement vos templates personnalisés afin d'obtenir un forum fonctionnel.