Actions

FAQ de Instalação: Difference between revisions

From LimeSurvey Manual

No edit summary
m (Text replacement - " enclose="div"" to "")
 
(23 intermediate revisions by 2 users not shown)
Line 18: Line 18:
=Iniciar a instalação= <!--T:2-->
=Iniciar a instalação= <!--T:2-->


Como criar um banco de dados e um usuário no MySQL utilizando linha de commando?<!--T:3-->
==Como criar um banco de dados e um usuário no MySQL utilizando linha de commando?==<!--T:3-->


<!--T:4-->
<!--T:4-->
Line 52: Line 52:
Normalmente, o script cria um novo banco de dados e, em seguida, a estrutura de tabelas. No entanto, se o seu servidor / ISP não lhe der direitos de administrador para criar um novo banco de dados no MySQL, você precisará entrar em contato com o administrador do servidor para solicitar a criação do banco de dados necessário (ou ter permissão para criá-lo você mesmo). Eles devem criar um banco de dados em branco para você com os direitos de acesso apropriados (ou seja: ler / escrever / criar). Inicie a instalação LimeSurvey normalmente e, em seguida, ele criará as tabelas no banco de dados.
Normalmente, o script cria um novo banco de dados e, em seguida, a estrutura de tabelas. No entanto, se o seu servidor / ISP não lhe der direitos de administrador para criar um novo banco de dados no MySQL, você precisará entrar em contato com o administrador do servidor para solicitar a criação do banco de dados necessário (ou ter permissão para criá-lo você mesmo). Eles devem criar um banco de dados em branco para você com os direitos de acesso apropriados (ou seja: ler / escrever / criar). Inicie a instalação LimeSurvey normalmente e, em seguida, ele criará as tabelas no banco de dados.


==Blank page when accessing the Install page== <!--T:26-->
==Página em branco ao acessar a página de instalação== <!--T:26-->


<!--T:27-->
<!--T:27-->
The problem is not with the LimeSurvey installation but with the PHP installation.
O problema não é com a instalação do LimeSurvey, mas com a instalação do PHP.
*Verify you have the MySQL PHP module (php-mysql) installed.
* Verifique se você tem o módulo PHP MySQL (php-mysql) instalado.  
*Verify your PHP install is loading the PHP.ini file your are modifying and not parsing other PHP.INI files on your system.
* Verifique se a sua instalação do PHP está carregando o arquivo PHP.ini que você está modificando, e não analisando outros arquivos PHP.INI no seu sistema.
*Verify the location and permissions of the following setting in your PHP.ini
* Verifique a localização e as permissões da seguinte configuração no seu PHP.ini:


<!--T:28-->
<!--T:28-->
<syntaxhighlight lang="c" enclose="div">upload_tmp_dir="/temp"
<syntaxhighlight lang="c">upload_tmp_dir="/temp"


<!--T:29-->
session.save_path="/temp"</syntaxhighlight>
session.save_path="/temp"</syntaxhighlight>
*Verify your server runs a suitable PHP version (e.g. this "blank page" problem appeared with PHP v4.4 and LimeSurvey v2.00+).


==Error messages because of non-existing resources== <!--T:30-->
* Verifique se o servidor executa uma versão adequada do PHP (por exemplo, este problema de "página em branco" apareceu com PHP v4.4 e LimeSurvey v2.00 +).
 
==Mensagens de erro devido a recursos não existentes== <!--T:30-->


<!--T:31-->
<!--T:31-->
Sometimes files are not uploaded correctly or were broken during upload. This leads to several different error messages. Most of them refer to a file or function within a file which can't be found.
Às vezes, os arquivos não são carregados corretamente ou são corrompidos durante o upload. Isso leva a várias mensagens de erro diferentes. A maioria delas se refere a arquivos ou funções dentro de arquivos que não podem ser encontrados.


<!--T:32-->
<!--T:32-->
'''Solution:''' Re-upload all files using the binary mode of your FTP program.
'''Solução:''' Refaça o upload de todos os arquivos usando o modo binário de seu programa FTP.


=Requirements page= <!--T:130-->
=Página de requisitos= <!--T:130-->


==What is this mbstring (Multibyte String Functions) library?== <!--T:15-->
==O que é a biblioteca mbstring (Multibyte String Functions)?== <!--T:15-->


<!--T:16-->
<!--T:16-->
The mbstring library is a PHP library to be able to 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
A biblioteca mbstring é uma biblioteca PHP para conversão de conjuntos de caracteres de um idioma para outro. Você precisa dela se quiser executar o LimeSurvey. Para verificar se já está instalado, abra a URL


<!--T:17-->
<!--T:17-->
  <nowiki>http://<your_server>/<your_limesurvey_directory>/admin/install/phpinfo.php</nowiki>
  <nowiki>http://<seu_servidor>/<seu_diretorio_limesurvey>/admin/install/phpinfo.php</nowiki>


<!--T:18-->
<!--T:18-->
from the web browser. A lot of information will be shown. Search for the string 'mbstring' under the '''Configuration''' section.
do navegador Web. Você verá muita informação nesta página. Procure por 'mbstring' na seção '' 'Configuração' ''.


<!--T:19-->
<!--T:19-->
If you find the mbstring section then all should be well and you can continue on with your LimeSurvey installation!
Se você encontrar a seção mbstring, está tudo certo e você pode continuar com sua instalação LimeSurvey!


<!--T:20-->
<!--T:20-->
'''If you don't find the mbstring section''' you might have a problem on your hands.
'''Se você não encontrar a seção mbstring''' você poderá ter problemas.


<!--T:21-->
<!--T:21-->
There are three possible scenarios:
Há três cenários possíveis:
*If it's your providers server: Ask your provider to activate that extension in PHP or how to activate it - if you have a good administration panel for your server you may be able to activate it yourself.
*Caso você esteja utilizando um provedor de serviços: Peça ao seu provedor a ativação dessa extensão PHP, ou pergunte como você pode fazer a ativação - se você tiver um bom painel de administração para o seu servidor, é possível que você tenha permissão para isso.
*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. In most Linux versions today you can install it using your Linux packet manager.
*Caso você esteja utilizando seu próprio servidor '''Linux''': Talvez seja necessário recompilar o PHP e incluir a biblioteca mbstring. Pergunte aos especialistas Linux como fazer isso. Atualmente, na maioria das versões do Linux, você pode instalá-la usando o gerenciador de pacotes do Linux.
**If you are using a version of Linux that supports 'yum' (CentOS, RedHat, Fedora):
**Se você estiver usando uma versão Linux com suporte a 'yum' (CentOS, RedHat, Fedora):
### Use the terminal (as a super user) and type: '''yum install php-mbstring'''
### Use o terminal (como super usuário) e digite: '''yum install php-mbstring'''
### Make sure to update /etc/php.ini to update and uncomment the various mbstring params
### Certifique-se de atualizar /etc/php.ini para atualizar e descomentar os vários parâmetros mbstring
### Make sure to restart apache after installing it:  '''/etc/init.d/httpd restart'''
### Certifique-se de reiniciar o apache após a instalação:  '''/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 that string is commented out with a semicolon. Remove the semicolon, save and restart your web server.
*Caso você esteja utilizando o seu próprio servidor '''Windows''': Procure pelo php.ini em seu sistema, abra-o com um editor e procure por mbstring. Muito provavelmente a linha que contém essa string é comentada com um ponto-e-vírgula. Remova o ponto e vírgula, salve e reinicie o servidor Web.


== Stuck at checking file system permissions == <!--T:131-->
== Problemas com a verificação das permissões do sistema de arquivos == <!--T:131-->
If SELinux is activated (primarily on CentOS) then you might get an error that the file system permissions are not correct but the list of directories is empty. SELinux prevents writing even though the permissions are on e.g. 777 or 755.
Se o SELinux estiver ativado (principalmente no CentOS), você poderá receber um erro informando que as permissões do sistema de arquivos não estão corretas, mas a lista de diretórios está vazia. O SELinux evita a escrita mesmo que as permissões sejam, por ex. 777 ou 755.
You need to configure SELinux for your server correctly - check out the [https://wiki.centos.org/HowTos/SELinux SELinux documentation].
Você precisa configurar SELinux corretamente para o seu servidor - confira a documentação em [https://wiki.centos.org/HowTos/SELinux SELinux].


=After database creation= <!--T:35-->
=Após a criação do banco de dados= <!--T:35-->


==Blank page after database creation== <!--T:36-->
==Página em branco após a criação do banco de dados== <!--T:36-->


===Symptoms=== <!--T:37-->
===Sintomas=== <!--T:37-->
* LimeSurvey installed OK, and database was created, but instead of the admin page, you get an empty page
* LimeSurvey foi instalado corretamente, e o banco de dados foi criado, mas no lugar da página de administração, você recebe uma página vazia
* Web surver log shows "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"
* o log do servidor Web mostra "Erro fatal: Chamada a um membro de uma função ou um não-objeto em /path/to/limesurvey/admin/login_check.php on line 69"


===Fix=== <!--T:38-->
===Solução=== <!--T:38-->


<!--T:39-->
<!--T:39-->
This is probably an incorrect setting for $rooturl or $rootdir in config.php. In particular, config.php attempts to set $rootdir correctly by calling <nowiki>dirname('''FILE''')</nowiki> and 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. Try setting $rootdir manually, and in particular, while your shell or pwd command may show a path like "/disks/hostname/home/username/public_html/limesurvey", try using "/home/username/public_html/limesurvey".
Esta é provavelmente uma configuração incorreta para $ rooturl ou $ rootdir no config.php. Em particular, config.php tenta definir $ rootdir corretamente chamando <nowiki> dirname ('' 'FILE' '') </ nowiki>, e enquanto isso normalmente funciona, ele pode apresentar problemas quando o LimeSurvey é instalado em uma home de usuário ou diretório Public_html e o diretório home são montados em NFS. Experimente definir $ rootdir manualmente e, em particular, quando o comando shell ou pwd mostrarem um caminho como "/ disks / nome_do_host / home / nome_do_usuário / public_html / limesurvey", tente usar "/home/nome_do_usuario/public_html/limesurvey".'


==When accessing admin page, the browser keeps running and will eventually fail to show it== <!--T:40-->
==Ao acessar a página de administração, o navegador continua em execução mas não exibe a página== <!--T:40-->


===Symptoms=== <!--T:41-->
===Sintomas=== <!--T:41-->
* LimeSurvey installed OK and database was created. But when you access the admin page, the browser keeps running and will eventually fail to show the page.
* A instalação do LimeSurvey ocorreu corretamente e a base de dados foi criada. Mas quando você acessa a página de administração, o navegador continua em execução mas não exibe a página.
* When you check the web server access log, its size has become so big (in some cases, more than 2 GB).
* Quando você verifica o log de acesso do servidor web, seu tamanho se tornou muito grande (em alguns casos, mais de 2 GB).
* Inside the access log, you get this message filling the log.
* Dentro do log de acesso, você recebe essa mensagem preenchendo o log:


<!--T:42-->
<!--T:42-->
Line 132: Line 132:


<!--T:43-->
<!--T:43-->
''Note:'' line number may be different depending on your LimeSurvey version.
''Nota:'' o número da linha pode ser diferente dependendo da versão do LimeSurvey.


===Fix=== <!--T:44-->
===Solução=== <!--T:44-->


<!--T:45-->
<!--T:45-->
This may be caused by the mbstring.func_overload setting. Check the setting in your php.ini and set as the following.
Isso pode ser causado pela configuração mbstring.func_overload. Verifique a configuração em seu php.ini e defina como o seguinte:


<!--T:46-->
<!--T:46-->
Line 143: Line 143:


<!--T:47-->
<!--T:47-->
''Note:'' This means no function overloading. See PHP manual for this setting: [http://us3.php.net/manual/en/mbstring.overload.php Function Overloading Feature]
''Nota:'' Isso desabilita a sobrecarga de função. Consulte o manual do PHP para esta configuração: [http://us3.php.net/manual/en/mbstring.overload.php Funcionalidade de sobrecarga de função


==When accessing admin page, the browser reports Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76== <!--T:48-->
==Ao acessar a página de administração, o navegador reporta: Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76== <!--T:48-->


===Symptoms=== <!--T:49-->
===Sintomas=== <!--T:49-->
* LimeSurvey installed OK and database was created. But when rdirected to the admin page, the browser displayed the the listed error.
* A instalação do LimeSurvey foi realizada corretamente e a base de dados foi criada. Mas ao redirecionar para a página de administração, o navegador exibe o erro.
* $rootdir and $rooturl are correctly set in config.php.
* $rootdir e $rooturl estão configurados corretamente em config.php.
* The disk path name for limesurvey installation directory includes one of the following characters: ()+
* O nome do caminho para o diretório de instalação do limesurvey inclui um dos seguintes caracteres: ()+


<!--T:50-->
<!--T:50-->
''Note:'' Other characters may also induce the same behaviour
''Nota:'' Outros caracteres também podem induzir o mesmo comportamento.


===Fix=== <!--T:51-->
===Solução=== <!--T:51-->


<!--T:52-->
<!--T:52-->
Move / rename the limesurvey installation directory so that pathname does not include either the '''(''' or ''')''' characters
Mover / renomear o diretório de instalação do limesurvey para que o pathname não inclua os caracteres '''(''' ou ''')'''


=After installation= <!--T:123-->  
=Após a instalação= <!--T:123-->  


<!--T:124-->
<!--T:124-->
For all issues happening after a successful installation please refer to the [[Troubleshooting]] page.
Para todos os problemas que vierem a ocorrer após uma instalação bem-sucedida, consulte a página [[Solução de problemas]].

Latest revision as of 15:08, 16 February 2022


Instalação no seu computador

LimeSurvey pode ser instalado no seu computador com MAMP/XAMP ou qualquer outro sistema. Mas o seu computador não é um servidor web: não está acessível via web para outro usuário.

Então, se você quer disponibilizar sua pesquisa na web você deve:

  • ter um servidor
  • ou um espaço em um servidor através de um serviço de hospedagem
  • encontrar um serviço de hospedagem especializado em limesurvey
  Com a instalação em seu computador não será possível compartilhar sua pesquisa na Internet.


Iniciar a instalação

Como criar um banco de dados e um usuário no MySQL utilizando linha de commando?

Você precisa rodar os comandos abaixo em seu MySQL.

create database <nome_do_banco_de_dados>;

create user <nome_do_usuario_do_banco_de_dados>;

create user <nome_do_usuario_do_banco_de_dados>@localhost;

set password for <nome_do_usuario_do_banco_de_dados> = PASSWORD('<senha_do_banco_de_dados>');

set password for <nome_do_usuario_do_banco_de_dados>@localhost = PASSWORD('<senha_do_banco_de_dados>');

grant all on <nome_do_banco_de_dados>.* to '<nome_do_usuario_do_banco_de_dados>';

grant all on <nome_do_banco_de_dados>.* to '<nome_do_usuario_do_banco_de_dados>'@'localhost';

Você precisa substituir <nome_do_banco_de_dados>, <nome_do_usuario_do_banco_de_dados> e <senha_do_banco_de_dados> nos comandos acima pelos valores correspondentes.

E se eu não conseguir criar o banco de dados através do script?

Normalmente, o script cria um novo banco de dados e, em seguida, a estrutura de tabelas. No entanto, se o seu servidor / ISP não lhe der direitos de administrador para criar um novo banco de dados no MySQL, você precisará entrar em contato com o administrador do servidor para solicitar a criação do banco de dados necessário (ou ter permissão para criá-lo você mesmo). Eles devem criar um banco de dados em branco para você com os direitos de acesso apropriados (ou seja: ler / escrever / criar). Inicie a instalação LimeSurvey normalmente e, em seguida, ele criará as tabelas no banco de dados.

Página em branco ao acessar a página de instalação

O problema não é com a instalação do LimeSurvey, mas com a instalação do PHP.

  • Verifique se você tem o módulo PHP MySQL (php-mysql) instalado.
  • Verifique se a sua instalação do PHP está carregando o arquivo PHP.ini que você está modificando, e não analisando outros arquivos PHP.INI no seu sistema.
  • Verifique a localização e as permissões da seguinte configuração no seu PHP.ini:
upload_tmp_dir="/temp"

session.save_path="/temp"
  • Verifique se o servidor executa uma versão adequada do PHP (por exemplo, este problema de "página em branco" apareceu com PHP v4.4 e LimeSurvey v2.00 +).

Mensagens de erro devido a recursos não existentes

Às vezes, os arquivos não são carregados corretamente ou são corrompidos durante o upload. Isso leva a várias mensagens de erro diferentes. A maioria delas se refere a arquivos ou funções dentro de arquivos que não podem ser encontrados.

Solução: Refaça o upload de todos os arquivos usando o modo binário de seu programa FTP.

Página de requisitos

O que é a biblioteca mbstring (Multibyte String Functions)?

A biblioteca mbstring é uma biblioteca PHP para conversão de conjuntos de caracteres de um idioma para outro. Você precisa dela se quiser executar o LimeSurvey. Para verificar se já está instalado, abra a URL

http://<seu_servidor>/<seu_diretorio_limesurvey>/admin/install/phpinfo.php

do navegador Web. Você verá muita informação nesta página. Procure por 'mbstring' na seção 'Configuração' .

Se você encontrar a seção mbstring, está tudo certo e você pode continuar com sua instalação LimeSurvey!

Se você não encontrar a seção mbstring você poderá ter problemas.

Há três cenários possíveis:

  • Caso você esteja utilizando um provedor de serviços: Peça ao seu provedor a ativação dessa extensão PHP, ou pergunte como você pode fazer a ativação - se você tiver um bom painel de administração para o seu servidor, é possível que você tenha permissão para isso.
  • Caso você esteja utilizando seu próprio servidor Linux: Talvez seja necessário recompilar o PHP e incluir a biblioteca mbstring. Pergunte aos especialistas Linux como fazer isso. Atualmente, na maioria das versões do Linux, você pode instalá-la usando o gerenciador de pacotes do Linux.
    • Se você estiver usando uma versão Linux com suporte a 'yum' (CentOS, RedHat, Fedora):
      1. Use o terminal (como super usuário) e digite: yum install php-mbstring
      2. Certifique-se de atualizar /etc/php.ini para atualizar e descomentar os vários parâmetros mbstring
      3. Certifique-se de reiniciar o apache após a instalação: /etc/init.d/httpd restart
  • Caso você esteja utilizando o seu próprio servidor Windows: Procure pelo php.ini em seu sistema, abra-o com um editor e procure por mbstring. Muito provavelmente a linha que contém essa string é comentada com um ponto-e-vírgula. Remova o ponto e vírgula, salve e reinicie o servidor Web.

Problemas com a verificação das permissões do sistema de arquivos

Se o SELinux estiver ativado (principalmente no CentOS), você poderá receber um erro informando que as permissões do sistema de arquivos não estão corretas, mas a lista de diretórios está vazia. O SELinux evita a escrita mesmo que as permissões sejam, por ex. 777 ou 755. Você precisa configurar SELinux corretamente para o seu servidor - confira a documentação em SELinux.

Após a criação do banco de dados

Página em branco após a criação do banco de dados

Sintomas

  • LimeSurvey foi instalado corretamente, e o banco de dados foi criado, mas no lugar da página de administração, você recebe uma página vazia
  • o log do servidor Web mostra "Erro fatal: Chamada a um membro de uma função ou um não-objeto em /path/to/limesurvey/admin/login_check.php on line 69"

Solução

Esta é provavelmente uma configuração incorreta para $ rooturl ou $ rootdir no config.php. Em particular, config.php tenta definir $ rootdir corretamente chamando <nowiki> dirname ( 'FILE' ) </ nowiki>, e enquanto isso normalmente funciona, ele pode apresentar problemas quando o LimeSurvey é instalado em uma home de usuário ou diretório Public_html e o diretório home são montados em NFS. Experimente definir $ rootdir manualmente e, em particular, quando o comando shell ou pwd mostrarem um caminho como "/ disks / nome_do_host / home / nome_do_usuário / public_html / limesurvey", tente usar "/home/nome_do_usuario/public_html/limesurvey".'

Ao acessar a página de administração, o navegador continua em execução mas não exibe a página

Sintomas

  • A instalação do LimeSurvey ocorreu corretamente e a base de dados foi criada. Mas quando você acessa a página de administração, o navegador continua em execução mas não exibe a página.
  • Quando você verifica o log de acesso do servidor web, seu tamanho se tornou muito grande (em alguns casos, mais de 2 GB).
  • Dentro do log de acesso, você recebe essa mensagem preenchendo o log:

Warning: fread() [function.fread]: Length parameter must be greater than 0 in /limesurvey/classes/php-gettext/streams.php on line 120

Nota: o número da linha pode ser diferente dependendo da versão do LimeSurvey.

Solução

Isso pode ser causado pela configuração mbstring.func_overload. Verifique a configuração em seu php.ini e defina como o seguinte:

mbstring.func_overload = 0

Nota: Isso desabilita a sobrecarga de função. Consulte o manual do PHP para esta configuração: [http://us3.php.net/manual/en/mbstring.overload.php Funcionalidade de sobrecarga de função

Ao acessar a página de administração, o navegador reporta: Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76

Sintomas

  • A instalação do LimeSurvey foi realizada corretamente e a base de dados foi criada. Mas ao redirecionar para a página de administração, o navegador exibe o erro.
  • $rootdir e $rooturl estão configurados corretamente em config.php.
  • O nome do caminho para o diretório de instalação do limesurvey inclui um dos seguintes caracteres: ()+

Nota: Outros caracteres também podem induzir o mesmo comportamento.

Solução

Mover / renomear o diretório de instalação do limesurvey para que o pathname não inclua os caracteres ( ou )

Após a instalação

Para todos os problemas que vierem a ocorrer após uma instalação bem-sucedida, consulte a página Solução de problemas.