Actions

Installation FAQ/it: Difference between revisions

From LimeSurvey Manual

m (Text replacement - " enclose="div"" to "")
(Updating to match new version of source page)
Line 5: Line 5:
==Installazione sul proprio computer==
==Installazione sul proprio 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.  
<div class="mw-translate-fuzzy">
LimeSurvey può essere installato sul proprio computer attraverso MAMP/XAMP o qualsiasi altro sistema. Solo che il proprio computer non è un server web: non è accessibile via web dagli altri utenti.
</div>


In order to make your survey reachable to other users via the web, you need to either:  
<div class="mw-translate-fuzzy">
Quindi, se vuoi diffondere il tuo questionario nel web, devi:
</div>


* own a server or a web space from a host provider
<div class="mw-translate-fuzzy">
* or find a LimeSurvey-specialized host provider
* possedere un server
* o avere uno spazio web in hosting
* trovare un hoster specializzato in istanze LimeSurvey.
</div>


{{Alert|An installation on your computer is not done to share your survey on the internet!}}
<div class="mw-translate-fuzzy">
{{Alert|L'installazione sul proprio computer non è fatta per condividere il proprio sondaggio via internet.}}
</div>


==Inizio Installazione==
==Inizio Installazione==


==How can I create a database and a user in MySQL with command-line access?==
<div class="mw-translate-fuzzy">
==Come posso creare un database ed un utente in MySQL con l'accesso a linea di comando?==
</div>


You have to enter the commands below in your MySQL:
<div class="mw-translate-fuzzy">
Devi inserire i comandi sottostanti nel tuo MySQL:
</div>


*<code>create database '''<your_database_name>''';</code>
<div class="mw-translate-fuzzy">
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>'''local@host = 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>
*<code>grant all on '''<your_database_name>'''.* to ''''<your_database_username>''''@'localhost';</code>
Line 38: Line 63:
==Cosa succede se non posso creare un database tramite lo script di LimeSurvey?==
==Cosa succede se non posso creare un database tramite lo script di LimeSurvey?==


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">
Normalmente lo script crea un nuovo database e, successivamente, la struttura delle tabelle. Se il Provider Internet non fornisce direttamente i permessi per creare un nuovo database in MySQL allora sarà necessario contattare l'amministratore del server per creare manualmente il database (e farsi dare il nome e il login) che dovrà avere i corretti permessi di accesso (leggi/scrivi/esegui). In questo caso bisognerà inserire il nome del database, oltre al nome utente e alla password, nel file config.php prima di lanciare il file admin.php. Solo a questo punto lo script potrà creare la struttura delle tabelle.
</div>


==Blank page when accessing the install page==
<div class="mw-translate-fuzzy">
==Pagina bianca quando si accede alla pagina d'installazione==
</div>


This problem doesn't occur within the LimeSurvey installation but within the PHP installation.
<div class="mw-translate-fuzzy">
*Verify you have the MySQL PHP module (php-mysql) installed.
Questo problema ha a che fare con l'installazione di PHP e non con l'installazione di LimeSurvey:
*Verify your PHP install is loading the PHP.ini file your are modifying and not parsing other PHP.INI files on your system.
* Verifica che sia installato il modulo MySQL PHP (php-mysql).
*Verify the location and permissions of the following setting in your PHP.ini:
* Verifica che l'istanza PHP stia caricando il file PHP.ini che stai modificando e che non compaiano altri file PHP.ini nel tuo sistema.
* Verifica il percorso e i permessi delle seguenti impostazioni all'interno del tuo file PHP.ini
</div>


<syntaxhighlight lang="c">upload_tmp_dir="/temp"
<syntaxhighlight lang="c">upload_tmp_dir="/temp"


<div class="mw-translate-fuzzy">
session.save_path="/temp"</syntaxhighlight>
session.save_path="/temp"</syntaxhighlight>
*Verify that your server runs a suitable PHP version.
* Verifica che il tuo server stia eseguendo una versione corretta di PHP (per esempio: questa "pagina bianca" appariva in PHP v4.4 e LimeSurvey v2.00+)
</div>


==Error messages due to non-existing resources==
<div class="mw-translate-fuzzy">
==Messaggi di errore per risorse inesistenti"
</div>


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.
<div class="mw-translate-fuzzy">
Qualche volta i file possono non essere caricate correttamente oppure corrotte durante l'upload. Ciò determina messaggi d'errore differenti. La maggior parte di essi si riferisce a file o funzioni contenuti in un file che non è reperibile.
</div>


'''Solution:''' Re-upload all files using the binary mode of your FTP programme.
<div class="mw-translate-fuzzy">
'''Soluzione:''' Ricarica tutti i file utilizzando la modalità binaria del tuo software FTP.
</div>


==Pagina Requisiti==
==Pagina Requisiti==


==What is the mbstring (Multibyte String Functions) library?==
<div class="mw-translate-fuzzy">
===Cos'e' la PHP Multibyte String Functions library?===
</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">
La PHP Multibyte String Functions library (o ''mbstring '' per PHP) e' una estensione per PHP che serve per manipolare le stringhe di caratteri non limitate a 8 bits. Questo e' il caso per caratteri cirillici, orientali etc che richiedono carattei rappresentati da stringhe di lunghezza in multipli di 8.
 
Per attivare questa estensione bisogna avere accesso al php.ini file. A seconda dell'installazione di PHP, o del server sui cui avete installato LimeSurvey, questa opzione e' disponibile in diversi modi.
* Nel caso di XAMPP e' necessario aprire il file php.ini e rimuovere i commenti (o aggiungere come nell'esempio) nelle linee che incominciano con ''mbstring ''usando il seguente formato:
 
<div class="simplebox">
 
; Opzioni del linguaggio
 
mbstring.language        = Neutral    ; definisci la lingua standard Neutral(UTF-8) (default)
 
mbstring.detect_order    = auto
 
mbstring.internal_encoding    = UTF-8  ; Susa l'encoding intenro del sistema UTF-8
 
mbstring.encoding_translation = On
 
mbstring.detect_order         = auto    ; attiva l'ordine di inizializzazione delle lingue automatico
 
</div>
* Nel caso utilizzate un hosting provider esterno, a seconda del tipo di servizio disponibile, e' possibile che queste modifiche possono essere fatte ne .htaccess file.
 
'''Consultate il vostro hosting provider prima di fare qualsiasi modifica poiche' il cambiamento dei file di configurazione potrebbe risultare in un malfunzionameto del server!'''
</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>
Line 68: Line 133:
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!
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!


'''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
'''Se non trovi la sezione mbstring''' potresti avere un problema tra le mani.
*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 144:
==Pagina bianca dopo la creazione del database==
==Pagina bianca dopo la creazione del database==


===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
====Sintomi====
* 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 è installato correttamente e il database è stato creato ma al posto della pagina dell'amministratore, compare una pagina bianca.
* I log del server web mostrano "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"
</div>


===Fix===
===Fix===

Revision as of 21:37, 17 February 2022

Contenuti:

Installazione sul proprio computer

LimeSurvey può essere installato sul proprio computer attraverso MAMP/XAMP o qualsiasi altro sistema. Solo che il proprio computer non è un server web: non è accessibile via web dagli altri utenti.

Quindi, se vuoi diffondere il tuo questionario nel web, devi:

  • possedere un server
  • o avere uno spazio web in hosting
  • trovare un hoster specializzato in istanze LimeSurvey.
  L'installazione sul proprio computer non è fatta per condividere il proprio sondaggio via internet.


Inizio Installazione

Come posso creare un database ed un utente in MySQL con l'accesso a linea di comando?

Devi inserire i comandi sottostanti nel tuo MySQL:

create database <your_database_name>;

create user <your_database_username>;

create user <your_database_username>@localhost;

set password for <your_database_username> = PASSWORD('<your_database_password>');

set password for <your_database_username>local@host = PASSWORD('<your_database_password>');

grant all on <your_database_name>.* to '<your_database_username>';

  • grant all on <your_database_name>.* to '<your_database_username>'@'localhost';

In terminal, <your_database_name>, <your_database_username>, and <your_database_password> have to be replaced with the according/desired values.

Cosa succede se non posso creare un database tramite lo script di LimeSurvey?

Normalmente lo script crea un nuovo database e, successivamente, la struttura delle tabelle. Se il Provider Internet non fornisce direttamente i permessi per creare un nuovo database in MySQL allora sarà necessario contattare l'amministratore del server per creare manualmente il database (e farsi dare il nome e il login) che dovrà avere i corretti permessi di accesso (leggi/scrivi/esegui). In questo caso bisognerà inserire il nome del database, oltre al nome utente e alla password, nel file config.php prima di lanciare il file admin.php. Solo a questo punto lo script potrà creare la struttura delle tabelle.

Pagina bianca quando si accede alla pagina d'installazione

Questo problema ha a che fare con l'installazione di PHP e non con l'installazione di LimeSurvey:

  • Verifica che sia installato il modulo MySQL PHP (php-mysql).
  • Verifica che l'istanza PHP stia caricando il file PHP.ini che stai modificando e che non compaiano altri file PHP.ini nel tuo sistema.
  • Verifica il percorso e i permessi delle seguenti impostazioni all'interno del tuo file PHP.ini
upload_tmp_dir="/temp"

<div class="mw-translate-fuzzy">
session.save_path="/temp"
  • Verifica che il tuo server stia eseguendo una versione corretta di PHP (per esempio: questa "pagina bianca" appariva in PHP v4.4 e LimeSurvey v2.00+)

==Messaggi di errore per risorse inesistenti"

Qualche volta i file possono non essere caricate correttamente oppure corrotte durante l'upload. Ciò determina messaggi d'errore differenti. La maggior parte di essi si riferisce a file o funzioni contenuti in un file che non è reperibile.

Soluzione: Ricarica tutti i file utilizzando la modalità binaria del tuo software FTP.

Pagina Requisiti

Cos'e' la PHP Multibyte String Functions library?

La PHP Multibyte String Functions library (o mbstring per PHP) e' una estensione per PHP che serve per manipolare le stringhe di caratteri non limitate a 8 bits. Questo e' il caso per caratteri cirillici, orientali etc che richiedono carattei rappresentati da stringhe di lunghezza in multipli di 8.

Per attivare questa estensione bisogna avere accesso al php.ini file. A seconda dell'installazione di PHP, o del server sui cui avete installato LimeSurvey, questa opzione e' disponibile in diversi modi.

  • Nel caso di XAMPP e' necessario aprire il file php.ini e rimuovere i commenti (o aggiungere come nell'esempio) nelle linee che incominciano con mbstring usando il seguente formato:
Opzioni del linguaggio

mbstring.language        = Neutral    ; definisci la lingua standard Neutral(UTF-8) (default)

mbstring.detect_order    = auto

mbstring.internal_encoding    = UTF-8  ; Susa l'encoding intenro del sistema UTF-8

mbstring.encoding_translation = On

mbstring.detect_order         = auto    ; attiva l'ordine di inizializzazione delle lingue automatico

  • Nel caso utilizzate un hosting provider esterno, a seconda del tipo di servizio disponibile, e' possibile che queste modifiche possono essere fatte ne .htaccess file.

Consultate il vostro hosting provider prima di fare qualsiasi modifica poiche' il cambiamento dei file di configurazione potrebbe risultare in un malfunzionameto del server!

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

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!

Se non trovi la sezione mbstring potresti avere un problema tra le mani.

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.

Dopo la creazione del database

Pagina bianca dopo la creazione del database

Sintomi

  • LimeSurvey è installato correttamente e il database è stato creato ma al posto della pagina dell'amministratore, compare una pagina bianca.
  • I log del server web mostrano "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"

Fix

This is probably related to an incorrect setting for $rooturl or $rootdir in config.php. The file config.php attempts to set $rootdir correctly by calling dirname('''FILE'''). 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 $rootdir 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.

When accessing the admin page, the browser keeps running and will eventually fail to show it

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.