Actualiser à partir d'une version précédente

La traduction de cette page n'est pas terminée.

Avant de commencer...

... lisez ceci car c'est très important: Ne jamais oublier de faire une sauvegarde des fichiers et de la base de données de votre installation actuelle !

Vous pouvez le faire en utilisant les outils d'administration de la base de données comme phpMyAdmin et un gestionnaire de fichiers ! Si vous ne savez pas comment procéder pour faire les sauvegardes des fichiers et de la base, alors vous devez demander à quelqu'un de le faire pour vous ou de vous l'apprendre, ou alors utilisez la méthode ComfortUpdate qui est censée tout faire pour vous.

Recommendation to use ComfortUpdate

The easiest/safest way to upgrade is to use our ComfortUpdate service.

Méthode rapide (pour les changements mineurs de version)

Vous pouvez suivre les instructions ci-après si vous effectuez une actualisation mineure (comme par exemple le passage de la version 1.86 à 1.87).

• Avant de commencer, sauvegardez vos fichiers et votre base de données (on l'avait déjà dit, n'est-ce pas ?)
• Supprimez tous vos fichiers et dossiers SAUF
  • /application/config/config.php
  • le dossier /upload

Note: Si vous avez personnalisé les templates dans le dossier /upload/templates, prenez soin de "rafraîchir" vos modifications en tenant compte des changements pouvant advenir avec la nouvelle version de LimeSurvey. Le moyen le plus simple pour retrouver de tels changements : comparer les fichiers de votre ancien template avec la nouvelle version du template par défaut. Si vous voyez des différences autres que vos personnalisations, il faudra rafraîchir.

• Copiez les nouveaux fichiers et dossiers présents dans le paquet LimeSurvey que vous venez de télécharger et de dé-compacter vers l'emplacement de LimeSurvey dans votre serveur. Faites attention à ne pas écraser votre fichier actuel config.php (si vous faites cette erreur-là, vous pouvez vous récupérer en utilisant la sauvegarde préalable que vous n'avez pas oublié de faire, n'est-ce pas ?). Vous pouvez copier en écrasant tous les autres fichiers et dossiers - mais normalement vous les avez supprimés (sauf le fichier config.php et le dossier "upload") .
• Si vous remarquez des problèmes après la mise à jour : supprimez le cache de votre navigateur et les cookies!

Note: If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.

• Copy the new files from the new LimeSurvey package to the existing location.
• Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
• After the upgrade: Clear your browser cache and cookies!

La méthode complète (pour les grands sauts de version)

Malheureusement il y a quelques petites choses à faire, par conséquent veuillez lire attentivement les instructions suivantes

Mettre à jour depuis une version 1.50 ou plus vers n'importe quelle version supérieure à 2.xx

1. Télécharger la dernière version de LimeSurvey.
2. Préparer et sauvegarder l'ancienne installation
   1. Sauvegardez les fichiez de votre répertoire d'installation et la base données SQL juste au cas où :
      1. En ligne de commande, créez un zip (ou archive similaire) de l'ensemble du dossier d'installation (fichiers et arbirescence) Par exemple sous Linux 'tar cvzf foo.tgz cps100' va compresser et zipper entièrement le dossier cps100  ;
      2. Vous pouvez utiliser [httsp://www.phpmyadmin.net phpMyAdmin] pour exporter toutes vos tables, ou vous pouvez utiliser la fonction de sauvegarde de bases de données de LimeSurvey, laquelle est disponible dans le menu Configuration (sous l'onglet avancé) pour sauvegarder la base de données entière ;

Note: Dans les anciennes versions de LimeSurvey, cherchez le bouton LimeSurvey Administration pour exporter la base de données.

1. 1. Copiez votre fichier config.php file, le dossier template modifié, et le dossier /upload séparément pour y avoir accès rapidement ensuite.
2. Remplacer tous les répertoires d'installation :
   1. Supprimez tous les anciens fichiers dans le répertoire d'installation existant ;
   2. Uploadez et décompressez la nouvelle version du code dans le même répertoire d'installation ;
   3. Si votre version précédente est plus ancienne que 1.90, copiez tous les templates personnalisés dans '/upload/templates' - vous pouvez aussi devoir renommer chaque dossier de template dont le nom correspond à un template existant dans /templates.
   4. Copiez votre votre dossier '/upload' directory back to the old location;
   5. Vérifiez doublement les permissions des dossiers (un accès en écriture est requis pour /tmp, /upload, et leurs sous-dossiers) comme décrit dans wiki installation;
   6. Ouvrez http://<yourdomain>/<yourlimesurveydir>/admin dans votre navigateur et suivez les instructions (vous pouvez utiliser l'ancien config.php comme modèle). La base de données existante sera automatiquement détectée, et, si nécessaire, mise à jour après confirmation.
3. Vérifiez si des vérifications manuelles spéciales listées ci-dessous s'appliquent ;
4. Maintenant, videz le cache de votre navigateur et supprimez les cookies ! et ce sera prêt.

  Notez SVP que la structure des templates a changé lors du passage de la version 2.0x à la version 2.50 ou plus. Vos anciens templates ne fonctionneront pluscar le système de templates utilise maintenant des templates adaptatifs.

Vérifications après une mise à jour:

• depuis n'importe quelle version précédent la 2.xx: Les gabarits ont subit de nombreux changements. Veuillez vérifier que vos gabarits personnels continuent à vous convenir. Sinon vous devez les ré-éditer (vérifier par rapport aux gabarits originaux ce qui a changé). Le processus de mise à jour tente de remplacer l'inclusion de template.js par l'espace réservé {TEMPLATEJS}. Si vous avez des problèmes javascript avec vos gabarits personnels, vérifier si votre gabarit a l'espace réservé {TEMPLATEJS} dans startpage.pstpl.
• depuis une version précédent la v1.53: Lors de la mise à jour depuis une version antérieure à la 1.53 vers la dernière version, vérifier les droit globaux de l'utilisateur de chaque utilisateur. Il y a un nouveau droit superadmin introduit dans la version 1.53 qui peut donner à un utilisateur les mêmes droits que le compte d'administrateur créé pendant l'installation. Le script de mise à jour devine à qui donner ces droits dans l'ancienne version. Comme il n'est pas parfait, le résultat doit être soigneusement vérifié.

Upgrading from version 1.50 or later to any later 1.xx version

• Download the desired version of LimeSurvey
• Backup your files and database (did we already mention that?).
• Replace all the installation directory files
  • Delete all old files in the existing installation directory
  • Upload and unpack the new code version into the same installation directory
  • Edit or replace the config.php file:
    • If your previous version was < 1.70: Edit the new config.php in order to reflect the changes from the backup config.php file. Do not just overwrite the new config.php with your old one!
    • If your previous version was >= 1.70: Simply replace the new config.php with your backup config.php file (as the file format has not changed)
  • If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
  • Copy your /upload directory back to the old location
  • Double-check the permissions set on the directories of LimeSurvey (write access to /tmp, /upload, and to their subdirectories is required) as described in the installation wiki
• Finish the installation/upgrade process
  • Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
  • Remove or rename the /admin/install directory as/if instructed by the installation script
  • Check if any special manual checks apply (as listed below)

Special checks after an upgrade:

• From a version earlier than v1.53: When upgrading from a version before v1.53 to the latest version, please check the global user rights of each user. There was a new superadmin right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.

Upgrading from a version earlier than v1.50 (v1.0 through v1.44)

Since the data structure and a lot of other things were changed, upgrading from any version previous to v1.50 is NOT possible. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install version 1.50, import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to how an installation can be transferred for more details.

Upgrading using CLI

You can upgrade the database via the PHP CLI: php application/commands/console.php updatedb. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

Failed database upgrade

Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade. That may happen because of various reasons, different database version, unexpected data format or contents, unusual configurations or anything else that did not show up in our tests (yes, we test alot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version. This assumes that you still have the database and file backup, either from ComfortUpdate, or you created these manually.

Please execute the following steps:

• Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
• Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
• Delete the old database and restore the database from the original (1st) backup.

That's it. Everything should be back to normal.

A note about reporting this issue:

If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org

Note: A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.

FAQ

Can I upgrade even if I have active surveys?

Yes, you can. Exceptions may be mentioned in the thorough instructions above. We strongly advise to test your surveys after upgrade to check if your design templates still work alright.

How to convert *.sql/*.csv survey structure files to the latest LimeSurvey version?

Install version 1.50, import the file, and export the survey structure to the newer .csv format. Then install the latest Version 2.x and import the .csv format and export it to the current .lss format.