Actions

Installation FAQ/fr: Difference between revisions

From LimeSurvey Manual

m (Text replacement - " enclose="div"" to "")
(Updating to match new version of source page)
Line 16: Line 16:
=Starting installation=
=Starting installation=


==How can I create a database and a user in MySQL with command-line access?==
<div class="mw-translate-fuzzy">
===Comment créer la base de données et l'utilisateur par la ligne de commande.===
</div>


You have to enter the commands below in your MySQL:
You have to enter the commands below in your MySQL:


*<code>create database '''<your_database_name>''';</code>
<div class="mw-translate-fuzzy">
<syntaxhighlight lang="sql" enclose="div">create database <your_database_name>;
</div>


*<code>create user '''<your_database_username>''';</code>
<div class="mw-translate-fuzzy">
create user <your_database_username>;
</div>


*<code>create user '''<your_database_username>'''@localhost;</code>
<div class="mw-translate-fuzzy">
create user <your_database_username>@localhost;
</div>


*<code>set password for '''<your_database_username>''' = PASSWORD(''''<your_database_password>'''');</code>
<div class="mw-translate-fuzzy">
set password for <your_database_username> = PASSWORD('<your_database_password>');
</div>


*<code>set password for '''<your_database_username>'''@localhost = PASSWORD(''''<your_database_password>'''');</code>
<div class="mw-translate-fuzzy">
set password for <your_database_username>@localhost = PASSWORD('<your_database_password>');
</div>


*<code>grant all on '''<your_database_name>'''.* to ''''<your_database_username>'''';</code>
<div class="mw-translate-fuzzy">
grant all on <your_database_name>.* to '<your_database_username>';
</div>


*<code>grant all on '''<your_database_name>'''.* to ''''<your_database_username>''''@'localhost';</code>
<div class="mw-translate-fuzzy">
grant all on <your_database_name>.* to '<your_database_username>'@'localhost';</syntaxhighlight>
</div>


In terminal, <code>'''<your_database_name>'''</code>, <code>'''<your_database_username>'''</code>, and <code>'''<your_database_password>'''</code> have to be replaced with the according/desired values.
<div class="mw-translate-fuzzy">
Vous devez bien s&ucirc;r modifier <your_database_name>, <your_database_username> et <your_database_password> dans les commandes précédentes.
</div>


===Que faire si je ne peux pas créer de base de données gr&acirc;ce à un script ?===
===Que faire si je ne peux pas créer de base de données gr&acirc;ce à un script ?===


Normally, the script creates a new database, and then the table structure. However, if your server/ISP doesn't give you admin rights to create a new database in MySQL, you will need to contact your server administrator to get the necessary database created (or create it yourself if you receive the required permissions). The newly created blank database should include the appropriate access rights (i.e.: read/write/create). Then, you should be able start the LimeSurvey installation, which will create the tables within the newly created database.
<div class="mw-translate-fuzzy">
En temps normal, un script de LimeSurvey crée une nouvelle base de données avec les tables nécessaires. Cependant, si vous n'avez pas les droits suffisants pour créer une base de données MySQL sur le serveur ou celui de votre FAI, il faudra contacter son administrateur afin qu'il crée cette nouvelle base à votre place en vous donnant les droits requis dessus (càd Lecture / Écriture / Création). Renseignez ensuite le nom de cette base, votre nom d'utilisateur et votre mot de passe dans le fichier config.php puis exécutez le script /admin/install/index.php script. Celui-ci ajoutera toutes les tables nécessaires dans la base.
</div>


==Blank page when accessing the install page==
==Blank page when accessing the install page==
Line 60: Line 80:
=Requirements page=
=Requirements page=


==What is the mbstring (Multibyte String Functions) library?==
<div class="mw-translate-fuzzy">
===Qu'est-ce que la librairie "mbstring" ?===
</div>


The mbstring library is a PHP library that can convert char sets from one language to another. You need it if you want to run LimeSurvey. To check if it is already installed, open the URL from a web browser:  
<div class="mw-translate-fuzzy">
Il s'agit d'une librairie PHP qui permet de convertir les caractères d'une langue à l'autre. Vous en aurez besoin si vous voulez utiliser LimeSurvey. Pour vérifier si elle est installée sur votre système, créez un fichier test.php qui contiendra ceci :
</div>


  <nowiki>http://<your_server>/<your_limesurvey_directory>/admin/install/phpinfo.php</nowiki>
  <nowiki>http://<your_server>/<your_limesurvey_directory>/admin/install/phpinfo.php</nowiki>


A lot of information will be shown. Search for the string 'mbstring' in the '''Configuration''' section. If you find the mbstring section, then all should be well and you can continue with your LimeSurvey installation!
<div class="mw-translate-fuzzy">
Ouvrez ce fichier depuis votre navigateur web. Plein d'informations vont s'afficher. Recherchez le texte "mbstring" dans la section '''Configuration'''.
</div>


'''If you don't find the mbstring section''', you might have a problem on your hands. There are three possible scenarios:
<div class="mw-translate-fuzzy">
*If it's your host provider's server, ask for the activation of that extension in PHP or for further information on how you can activate it - if you have a good administration panel for your server, you may be able to activate it yourself
'''Si vous ne trouvez pas la section mbstring''', il va falloir régler ça...
*If it's your own '''Linux''' server, you may have to re-compile PHP and include the mbstring library. Ask the Linux experts how to do that. However, you can install it using your Linux package manager, which is mostly available in all the Linux distributions nowadays
</div>
**If you are using a version of Linux that supports 'yum' (CentOS, RedHat, Fedora)...
***...use the terminal (as a super user) and type: '''yum install php-mbstring'''
***...make sure to update /etc/php.ini and uncomment the various mbstring params
***...make sure to restart apache after installing it: '''/etc/init.d/httpd restart'''
*If it's your own '''Windows''' server, search for php.ini on your system, open it with an editor, and search for mbstring. Most probably, the line that contains the string is commented out with a semicolon. Remove the semicolon, save and restart your web server


== Stuck at checking file system permissions ==
== Stuck at checking file system permissions ==
Line 84: Line 105:
==Blank page after database creation==
==Blank page after database creation==


===Symptoms===
<div class="mw-translate-fuzzy">
* LimeSurvey is installed correctly and the database was created, but instead of the admin page, you get an empty page
====Symptômes :====
* Web server log shows ''"Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"''
* LimeSurvey est correctement installé, la base de données a été créée mais à la place de l'écran d'administration, vous obtenez une page vide.
* Vous pouvez lire ceci dans les logs du serveur web     * "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"
</div>


====Remède====
====Remède====


This is probably related to an incorrect setting for <code>$rooturl</code> or <code>$rootdir</code> in config.php. The file config.php attempts to set <code>$rootdir</code> correctly by calling <code><nowiki>dirname('''FILE''')</nowiki></code>. While this usually works, it can be upset when LimeSurvey is installed in a user's home or public_html directory and the home directory is mounted over NFS. To set up the <code>$rootdir</code> manually, (your shell or pwd command may show you a path like /disks/hostname/home/username/public_html/limesurvey), try using /home/username/public_html/limesurvey.
<div class="mw-translate-fuzzy">
C'est probablement à cause d'un mauvais réglage pour $rooturl ou $rootdir dans config.php. En effet, config.php essaie de déterminer correctement la valeur de $rootdir en appelant 'dirname('''FILE''')' et si cela fonctionne dans la plupart des cas, cela peut ne pas être le cas quand LimeSurvey est installé dans un répertoire d'utilisateur ou un dossier public_html et que le dossier de l'utilisateur est monté par NFS. Essayez de définir $rootdir manuellement et en particulier, si votre shell ou si la commande pwd vous retourne un chemin du genre "/disks/hostname/home/username/public_html/limewire", essayez d'utiliser "/home/username/public_html/limewire".


==When accessing the admin page, the browser keeps running and will eventually fail to show it==
ce problème peut aussi survenir par un paramétrage incorrect de $rooturl ou par l'oubli de l'activation de mbstrings.
</div>
 
<div class="mw-translate-fuzzy">
===Quelques erreurs courantes (essentiellement IIS)===
</div>


===Symptoms===
===Symptoms===

Revision as of 21:37, 17 February 2022

Contenu :

Installation on your computer

LimeSurvey can be installed on your computer with MAMP/XAMPP or any other system. Bear in mind that your computer is not a web server - it's not accessible via web to any other user.

In order to make your survey reachable to other users via the web, you need to either:

  • own a server or a web space from a host provider
  • or find a LimeSurvey-specialized host provider
  An installation on your computer is not done to share your survey on the internet!


Starting installation

Comment créer la base de données et l'utilisateur par la ligne de commande.

You have to enter the commands below in your MySQL:

create database <your_database_name>;
</div>

<div class="mw-translate-fuzzy">
create user <your_database_username>;
</div>

<div class="mw-translate-fuzzy">
create user <your_database_username>@localhost;
</div>

<div class="mw-translate-fuzzy">
set password for <your_database_username> = PASSWORD('<your_database_password>');
</div>

<div class="mw-translate-fuzzy">
set password for <your_database_username>@localhost = PASSWORD('<your_database_password>');
</div>

<div class="mw-translate-fuzzy">
grant all on <your_database_name>.* to '<your_database_username>';
</div>

<div class="mw-translate-fuzzy">
grant all on <your_database_name>.* to '<your_database_username>'@'localhost';

Vous devez bien sûr modifier <your_database_name>, <your_database_username> et <your_database_password> dans les commandes précédentes.

Que faire si je ne peux pas créer de base de données grâce à un script ?

En temps normal, un script de LimeSurvey crée une nouvelle base de données avec les tables nécessaires. Cependant, si vous n'avez pas les droits suffisants pour créer une base de données MySQL sur le serveur ou celui de votre FAI, il faudra contacter son administrateur afin qu'il crée cette nouvelle base à votre place en vous donnant les droits requis dessus (càd Lecture / Écriture / Création). Renseignez ensuite le nom de cette base, votre nom d'utilisateur et votre mot de passe dans le fichier config.php puis exécutez le script /admin/install/index.php script. Celui-ci ajoutera toutes les tables nécessaires dans la base.

Blank page when accessing the install page

This problem doesn't occur within the LimeSurvey installation but within the PHP installation.

  • Verify you have the MySQL PHP module (php-mysql) installed.
  • Verify your PHP install is loading the PHP.ini file your are modifying and not parsing other PHP.INI files on your system.
  • Verify the location and permissions of the following setting in your PHP.ini:
upload_tmp_dir="/temp"

session.save_path="/temp"
  • Verify that your server runs a suitable PHP version.

Error messages due to non-existing resources

Sometimes, files are not uploaded correctly or are broken during the upload process. This leads to several different error messages. Most of them refer to a file or function within a file which can't be found.

Solution: Re-upload all files using the binary mode of your FTP programme.

Requirements page

Qu'est-ce que la librairie "mbstring" ?

Il s'agit d'une librairie PHP qui permet de convertir les caractères d'une langue à l'autre. Vous en aurez besoin si vous voulez utiliser LimeSurvey. Pour vérifier si elle est installée sur votre système, créez un fichier test.php qui contiendra ceci :

http://<your_server>/<your_limesurvey_directory>/admin/install/phpinfo.php

Ouvrez ce fichier depuis votre navigateur web. Plein d'informations vont s'afficher. Recherchez le texte "mbstring" dans la section Configuration.

Si vous ne trouvez pas la section mbstring, il va falloir régler ça...

Stuck at checking file system permissions

If SELinux is activated (primarily on CentOS), then you might get an error that the file system permissions are not correct, even if the list of directories is empty. SELinux prevents writing even though the permissions are for example on 777 or 755. To configure SELinux correctly for your server - check out the SELinux documentation.

After database creation

Blank page after database creation

Symptômes :

  • LimeSurvey est correctement installé, la base de données a été créée mais à la place de l'écran d'administration, vous obtenez une page vide.
  • Vous pouvez lire ceci dans les logs du serveur web     * "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"

Remède

C'est probablement à cause d'un mauvais réglage pour $rooturl ou $rootdir dans config.php. En effet, config.php essaie de déterminer correctement la valeur de $rootdir en appelant 'dirname(FILE)' et si cela fonctionne dans la plupart des cas, cela peut ne pas être le cas quand LimeSurvey est installé dans un répertoire d'utilisateur ou un dossier public_html et que le dossier de l'utilisateur est monté par NFS. Essayez de définir $rootdir manuellement et en particulier, si votre shell ou si la commande pwd vous retourne un chemin du genre "/disks/hostname/home/username/public_html/limewire", essayez d'utiliser "/home/username/public_html/limewire".

ce problème peut aussi survenir par un paramétrage incorrect de $rooturl ou par l'oubli de l'activation de mbstrings.

Quelques erreurs courantes (essentiellement IIS)

Symptoms

  • LimeSurvey is installed correctly and the database was created. However, when you access the admin page, the browser keeps running and will eventually fail to show the page
  • When you check the web server access log, its size has become quite big (in some cases, more than 2 GB)
  • Inside the access log, you get this message filling the log:
  Warning : fread() [function.fread]: Length parameter must be greater than 0 in /limesurvey/classes/php-gettext/streams.php on line 120.

The line number may be different depending on your LimeSurvey version.

Fix

This may be caused by the mbstring.func_overload setting. Change the following setting in the php.ini file:

mbstring.func_overload = 0
This means no function overloading. See the PHP manual for this setting: Function Overloading Feature.

When accessing the admin page, the browser reports Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76

Symptoms

  • LimeSurvey is installed correctly and the database was created. But when redirected to the admin page, the browser displayed the listed error.
  • $rootdir and $rooturl are correctly set in config.php.
  • The disk path name for limesurvey installation directory includes one of the following characters: '(',')' or '+'.
  Attention : Other characters may also induce the same behavior.


Fix

Move/rename the LimeSurvey installation directory so that the path name includes non of the following characters: '(',')' or '+' characters.

After installation

For all the other issues that may occur after a successful installation, please refer to the troubleshooting page.