Actions

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

From LimeSurvey Manual

Revision as of 15:24, 29 August 2023 by Maren.fritz (talk | contribs)
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 un outil d'administration de base de données comme phpMyAdmin et un gestionnaire de fichiers ! Si vous ne savez pas comment procéder, n'allez pas plus loin et demandez à quelqu'un qui sait.

Recommandation d'utiliser ComfortUpdate

Le moyen le plus simple et le plus sûr de mettre à niveau est d'utiliser notre service ComfortUpdate.

Instructions de mise à niveau (de 2.x ou plus récent vers une version ultérieure)

Veuillez suivre ces instructions :

  • Sauvegardez vos fichiers et votre base de données (l'avons-nous déjà mentionné ?).
  • Supprimez tous les anciens fichiers/ dossiers sauf :
    • /application/config/security.php -Important!! C'est la clé de toutes les données cryptées dans LimeSurvey (version 4 et ultérieure)
    • /application/config/config.php;
    • /upload directory
Remarque : Si vous avez des modèles personnalisés dans /upload/templates, assurez-vous de les « actualiser » avec les modifications apportées avec la nouvelle version de LimeSurvey. Le moyen le plus simple de vérifier de telles modifications consiste à comparer votre ancien modèle avec la nouvelle version du modèle par défaut. Si vous constatez des différences autres que vos personnalisations, une actualisation est nécessaire.
  • Copiez les nouveaux fichiers du nouveau package LimeSurvey vers l'emplacement existant.
  • Ouvrez la page d'administration dans votre navigateur (par exemple https://www.example.com/limesurvey/admin) et vérifiez si une base de données une mise à jour du schéma est nécessaire.
  • Après la mise à niveau : Effacez le cache de votre navigateur et les cookies !

Instructions pour les anciennes versions

Malheureusement, il y a quelques éléments à prendre en compte, veuillez donc lire attentivement les instructions suivantes.

Mise à niveau de la version 1.50 ou ultérieure vers une version ultérieure 2.xx

  • Download la dernière version de LimeSurvey
  • Sauvegardez votre fichiers et base de données (l'avons-nous déjà mentionné ?).
  • Remplacez tous les fichiers du répertoire d'installation
    • Supprimez tous les anciens fichiers du répertoire d'installation existant
    • Téléchargez et décompressez les nouveaux fichiers de la nouvelle version dans le même répertoire d'installation
    • Si votre version précédente est antérieure à 1.90, copiez tous les modèles personnalisés dans /upload/templates - vous pourrez également vous devez renommer chaque répertoire de modèles dont le nom correspond à un modèle existant dans /templates
    • Copiez votre répertoire /upload à l'ancien emplacement
    • Vérifiez à nouveau les autorisations définies sur les répertoires (un accès en écriture à /tmp, /upload et à leurs sous-répertoires est requis) comme décrit dans le installation wiki
    • Open http://<yourdomain> /<yourlimesurveydir> /admin dans votre navigateur et suivez les instructions (vous trouverez les données de la base de données dans l'ancien config.php). La base de données existante sera automatiquement détectée et si nécessaire, mise à niveau après confirmation.
  • Vérifiez si des vérifications manuelles spéciales s'appliquent comme indiqué ci-dessous
  • Maintenant, effacez le cache et les cookies de votre navigateur et vous êtes bon d'y aller
  Attention : 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 spéciales après une mise à niveau :
  • de toute version antérieure vers 2.xx : les codes de questions appropriés sont désormais obligatoires. Après la mise à niveau de l'installation, vérifiez la logique d'enquête de toutes les enquêtes et corrigez les codes si nécessaire
  • à partir d'une version antérieure à v1.53 : lors d'une mise à niveau d'une version antérieure à v1.53 vers la dernière version , veuillez vérifier les droits globaux d'utilisation de chaque utilisateur. Un nouveau droit superadmin a été introduit dans la v1.53 qui peut donner à un utilisateur le même privilège que le compte d'administration principal créé lors de l'installation. Le script de mise à niveau consiste à deviner à qui cette autorisation doit être accordée dans les anciennes versions. Comme ce n'est pas parfait, cela doit être soigneusement vérifié.
  • de toute version antérieure à la v2.06 : De 2.05 à 2.06, certaines autorisations inutilisées lors de l'édition des autorisations globales pour les 'enquêtes' ont été activées. Par exemple, si un utilisateur disposait uniquement de l'autorisation « créer » dans la version 2.05, les autres autorisations situées à droite de « créer » seraient également activées avec la mise à jour vers la version 2.06 (Afficher/lire, Mettre à jour, Supprimer, Importer, Exporter). Veuillez vérifier si les utilisateurs administrateurs ont obtenu d'autres autorisations globales en plus de celles « d'origine » après la mise à jour. Si oui, veuillez les modifier en conséquence.

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 after manual update/ComfortUpdate

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 versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

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 your regular backup or the one created by Comfortupdate.

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

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.