Latest revision as of 10:53, 3 April 2024

Other languages:

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.

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

Download la version souhaitée 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 la nouvelle version du code dans le même répertoire d'installation
- Modifiez ou remplacez le fichier config.php:
  - Si votre version précédente était < 1,70 : Modifiez le nouveau config.php afin de refléter les modifications du fichier de sauvegarde config.php. Ne vous contentez pas d'écraser le nouveau config.php par votre ancien !
  - Si votre version précédente était >= 1.70 : Remplacez simplement le nouveau config.php. php avec votre fichier de sauvegarde config.php (car le format du fichier n'a pas changé)
- Si votre version précédente était antérieure à 1.90 : Copiez tous les modèles personnalisés dans /upload/templates - vous devrez également 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 l'ensemble des autorisations sur les répertoires de LimeSurvey (un accès en écriture à /tmp, /upload et à leurs sous-répertoires est requis) comme décrit dans le installation wiki
Terminez le processus d'installation/mise à niveau
- Une fois que vous ouvrez l'URL de votre administration LimeSurvey, les tables de la base de données seront mises à jour après confirmation
- Supprimez ou renommez le répertoire /admin/install comme/si indiqué par le script d'installation !N !** Vérifiez si des vérifications manuelles spéciales s'appliquent (comme indiqué ci-dessous)

Vérifications particulières après une mise à niveau :

'À 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 le 'droits d'utilisation globaux 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, il convient de le vérifier soigneusement.

Mise à niveau à partir d'une version antérieure à la v1.50 (v1.0 à v1.44)

Étant donné que la structure des données et beaucoup d'autres choses ont été modifiées, la mise à niveau depuis n'importe quelle version antérieure à la v1.50 n'est PAS possible. Si vous disposez d'anciens fichiers de structure d'enquête avec une extension *.sql, la seule façon de les intégrer dans une version plus récente est d'installer version 1.50 , importez-y le(s) fichier(s) .sql, puis mettez à niveau cette version vers la version la plus récente de LimeSurvey. Consultez la page relative à comment une installation peut être transférée pour plus de détails.

Mise à niveau à l'aide de CLI

Vous pouvez mettre à niveau la base de données via la CLI PHP : php application/commands/console.php updatedb . Cela vous permet de configurer un système de mise à niveau automatique via une ligne de commande (par exemple, dans une crontab), bien que cela ne soit pas recommandé.

Échec de la mise à niveau de la base de données après une mise à jour manuelle/ComfortUpdate

Parfois, même si vous avez tout fait correctement, les choses ne fonctionnent pas comme prévu lors de la mise à niveau de la base de données. Cela peut se produire pour diverses raisons : Différentes versions de la base de données , des formats ou contenus de données inattendus, des configurations inhabituelles ou tout autre élément qui n'est pas apparu lors de nos tests (oui, nous testons beaucoup !)

Si vous rencontrez une erreur lors de la mise à jour de la base de données et que votre instance LimeSurvey se retrouve dans un état inutilisable, vous souhaitez revenir à la version précédente. Cela suppose que vous disposez toujours de la sauvegarde de la base de données et des fichiers, soit à partir de votre sauvegarde habituelle, soit celui créé par Comfortupdate.

Veuillez exécuter les étapes suivantes :

Sauvegardez le répertoire et la base de données LimeSurvey existants (oui, encore une fois - nous appellerons cela la 2ème sauvegarde)
Restaurez les fichiers dans le répertoire existant (il suffit de les écraser) à partir de la (1ère) sauvegarde d'origine.
Supprimez l'ancienne base de données et restaurez la base de données à partir de la (1ère) sauvegarde d'origine.

C'est ça. Tout devrait revenir à la normale.

Une remarque concernant le signalement de ce problème :

Si vous rencontrez un problème comme celui-ci, veuillez toujours le signaler dans notre outil de suivi des bogues sur https://bugs.limesurvey.org

Un bug non signalé est un bug non corrigé. S'il vous plaît, ne vous fiez pas uniquement aux autres personnes qui le signalent. Si vous constatez que le bug est déjà signalé, vous pouvez également contribuer à augmenter la priorité du bug en le marquant comme « Oui, ce bug m'affecte » dans le suivi des bugs.

FAQ

Puis-je mettre à niveau même si j'ai des enquêtes actives ?

Oui, vous pouvez. Des exceptions peuvent être mentionnées dans les instructions détaillées ci-dessus. Nous vous conseillons fortement de tester vos enquêtes après la mise à niveau pour vérifier si vos modèles de conception fonctionnent toujours correctement.

Comment convertir les fichiers de structure d'enquête .sql/.csv vers la dernière version de LimeSurvey ?

Installez la version 1.50, importez le fichier et exportez la structure de l'enquête au nouveau format .csv. Installez ensuite la dernière version 2.x, importez le format .csv et exportez-le au format .lss actuel.

Survey theme incompatibility

With certain major version updates any custom survey themes will not be compatible, anymore:

Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

Error "Multiple primary key defined" when updating MySQL database

If you encounter this error, please check the setting sql_generate_invisible_primary_key in your MySQL server variables. This is most likely set to ON, but should be set to OFF. Then restore your database from the backup (as explained above) and try again.

@@ Line 44: / Line 44: @@
 {{Alert|title=Attention|text=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.}}
-<div class="mw-translate-fuzzy">
+<div class="simplebox">'''Vérifications spéciales après une mise à niveau''' :
-<div class="simplebox">'''Vérifications après une mise à jour''':
+*'''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
-*'''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.
+*'''à 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é.
-*'''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é.
+*'''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.
 </div>
-==Upgrading from version 1.50 or later to any later 1.xx version==
+==Mise à niveau de la version 1.50 ou ultérieure vers une version ultérieure 1.xx==
-*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
+*[https://www.limesurvey.org/about-limesurvey/download Download] la version souhaitée de LimeSurvey
-* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
+* Sauvegardez votre fichiers et base de données ([[Mise à niveau depuis une version précédente#Avant de commencer...|l'avons-nous déjà mentionné ?]]).
-* Replace all the installation directory files
+* Remplacez tous les fichiers du répertoire d'installation
-** Delete all old files in the existing installation directory
+** Supprimez tous les anciens fichiers du répertoire d'installation existant
-** Upload and unpack the new code version into the same installation directory
+** Téléchargez et décompressez la nouvelle version du code dans le même répertoire d'installation
-** Edit or replace the '''config.php''' file:
+** Modifiez ou remplacez le fichier '''config.php''':
-*** 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!'''
+*** Si votre version précédente était < 1,70 : Modifiez le nouveau '''config.php''' afin de refléter les modifications du fichier de sauvegarde '''config.php'''. '''Ne vous contentez pas d'écraser le nouveau '''config.php''' par votre ancien !'''
-*** 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)
+*** Si votre version précédente était >= 1.70 : Remplacez simplement le nouveau '''config.php. php''' avec votre fichier de sauvegarde '''config.php''' (car le format du fichier n'a pas changé)
-** 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
+** Si votre version précédente était antérieure à 1.90 : Copiez tous les modèles personnalisés dans /upload/templates - vous devrez également renommer chaque répertoire de modèles dont le nom correspond à un modèle existant dans /templates
-** Copy your /upload directory back to the old location
+** Copiez votre répertoire /upload à l'ancien emplacement
-** 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#Set Directory permissions|installation wiki]]
+** Vérifiez à nouveau l'ensemble des '''autorisations''' sur les répertoires de LimeSurvey (un accès en écriture à '''/tmp''', '''/upload''' et à leurs sous-répertoires est requis) comme décrit dans le [[Installation#Set Directory permissions|installation wiki]]
-* Finish the installation/upgrade process
+* Terminez le processus d'installation/mise à niveau
-** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
+** Une fois que vous ouvrez l'URL de votre administration LimeSurvey, les tables de la base de données seront mises à jour après confirmation
-** Remove or rename the /admin/install directory as/if instructed by the installation script
+** Supprimez ou renommez le répertoire /admin/install comme/si indiqué par le script d'installation !N !** Vérifiez si des vérifications manuelles spéciales s'appliquent (comme indiqué ci-dessous)
-** Check if any special manual checks apply (as listed below)
-<div class="simplebox">'''Special checks after an upgrade''':
+<div class="simplebox">'''Vérifications particulières après une mise à niveau''' :
-*'''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.
+*'''À 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 le '' 'droits d'utilisation globaux''' 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, il convient de le vérifier soigneusement.
 </div>
-==Upgrading from a version earlier than v1.50 (v1.0 through v1.44)==
+==Mise à niveau à partir d'une version antérieure à la v1.50 (v1.0 à v1.44)==
-Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> 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 [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.
+Étant donné que la structure des données et beaucoup d'autres choses ont été modifiées, '''la mise à niveau depuis n'importe quelle version antérieure à la v1.50 <u>n'est PAS</u> possible'''. Si vous disposez d'anciens fichiers de structure d'enquête avec une extension *.sql, la seule façon de les intégrer dans une version plus récente est d'installer [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50] , importez-y le(s) fichier(s) .sql, puis mettez à niveau cette version vers la version la plus récente de LimeSurvey. Consultez la page relative à [[Transférer une installation|comment une installation peut être transférée]] pour plus de détails.
-= Upgrading using CLI =
+= Mise à niveau à l'aide de CLI =
-You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.
+Vous pouvez mettre à niveau la base de données via la CLI PHP : <code>php application/commands/console.php updatedb</code> . Cela vous permet de configurer un système de mise à niveau automatique via une ligne de commande (par exemple, dans une crontab), bien que cela ne soit pas recommandé.
-= Failed database upgrade after manual update/ComfortUpdate=
+= Échec de la mise à niveau de la base de données après une mise à jour manuelle/ComfortUpdate=
-Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
+Parfois, même si vous avez tout fait correctement, les choses ne fonctionnent pas comme prévu lors de la mise à niveau de la base de données.
-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!)
+Cela peut se produire pour diverses raisons : Différentes versions de la base de données , des formats ou contenus de données inattendus, des configurations inhabituelles ou tout autre élément qui n'est pas apparu lors de nos tests (oui, nous testons beaucoup !)
-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.
+Si vous rencontrez une erreur lors de la mise à jour de la base de données et que votre instance LimeSurvey se retrouve dans un état inutilisable, vous souhaitez revenir à la version précédente.
-This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.
+Cela suppose que vous disposez toujours de la sauvegarde de la base de données et des fichiers, soit à partir de votre sauvegarde habituelle, soit celui créé par Comfortupdate.
-Please execute the following steps:
+Veuillez exécuter les étapes suivantes :
-*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
+*Sauvegardez le répertoire et la base de données LimeSurvey existants (oui, encore une fois - nous appellerons cela la 2ème sauvegarde)
-*Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
+*Restaurez les fichiers dans le répertoire existant (il suffit de les écraser) à partir de la (1ère) sauvegarde d'origine.
-*Delete the old database and restore the database from the original (1st) backup.
+* Supprimez l'ancienne base de données et restaurez la base de données à partir de la (1ère) sauvegarde d'origine.
-That's it. Everything should be back to normal.
+C'est ça. Tout devrait revenir à la normale.
-'''A note about reporting this issue:'''
+'''Une remarque concernant le signalement de ce problème :'''
-If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org
+Si vous rencontrez un problème comme celui-ci, veuillez toujours le signaler dans notre outil de suivi des bogues sur 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.
+Un bug non signalé est un bug non corrigé. S'il vous plaît, ne vous fiez pas uniquement aux autres personnes qui le signalent. Si vous constatez que le bug est déjà signalé, vous pouvez également contribuer à augmenter la priorité du bug en le marquant comme « Oui, ce bug m'affecte » dans le suivi des bugs.
 =FAQ=
-==Can I upgrade even if I have active surveys?==
+==Puis-je mettre à niveau même si j'ai des enquêtes actives ?==
-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.
+Oui, vous pouvez. Des exceptions peuvent être mentionnées dans les instructions détaillées ci-dessus. Nous vous conseillons fortement de tester vos enquêtes après la mise à niveau pour vérifier si vos modèles de conception fonctionnent toujours correctement.
-==How to convert *.sql/*.csv survey structure files to the latest LimeSurvey version?==
+==Comment convertir les fichiers de structure d'enquête *.sql/*.csv vers la dernière version de LimeSurvey ?==
-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.
+Installez la version 1.50, importez le fichier et exportez la structure de l'enquête au nouveau format .csv. Installez ensuite la dernière version 2.x, importez le format .csv et exportez-le au format .lss actuel.
+==Survey theme incompatibility==
+With certain major version updates any custom survey themes will not be compatible, anymore:
+* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
+* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x
+==Error "Multiple primary key defined" when updating MySQL database==
+If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Upgrading from a previous version/fr: Difference between revisions

From LimeSurvey Manual