FAQ de Instalação: Difference between revisions
From LimeSurvey Manual
No edit summary |
m (Text replacement - " enclose="div"" to "") |
||
(22 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. | ||
== | ==Página em branco ao acessar a página de instalação== <!--T:26--> | ||
<!--T:27--> | <!--T:27--> | ||
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: | ||
<!--T:28--> | <!--T:28--> | ||
<syntaxhighlight lang="c | <syntaxhighlight lang="c">upload_tmp_dir="/temp" | ||
session.save_path="/temp"</syntaxhighlight> | session.save_path="/temp"</syntaxhighlight> | ||
== | * 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--> | ||
À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--> | ||
''' | '''Solução:''' Refaça o upload de todos os arquivos usando o modo binário de seu programa FTP. | ||
= | =Página de requisitos= <!--T:130--> | ||
== | ==O que é a biblioteca mbstring (Multibyte String Functions)?== <!--T:15--> | ||
<!--T:16--> | <!--T:16--> | ||
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://< | <nowiki>http://<seu_servidor>/<seu_diretorio_limesurvey>/admin/install/phpinfo.php</nowiki> | ||
<!--T:18--> | <!--T:18--> | ||
do navegador Web. Você verá muita informação nesta página. Procure por 'mbstring' na seção '' 'Configuração' ''. | |||
<!--T:19--> | <!--T:19--> | ||
Se você encontrar a seção mbstring, está tudo certo e você pode continuar com sua instalação LimeSurvey! | |||
<!--T:20--> | <!--T:20--> | ||
''' | '''Se você não encontrar a seção mbstring''' você poderá ter problemas. | ||
<!--T:21--> | <!--T:21--> | ||
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): | ||
### Use | ### Use o terminal (como super usuário) e digite: '''yum install php-mbstring''' | ||
### | ### Certifique-se de atualizar /etc/php.ini para atualizar e descomentar os vários parâmetros mbstring | ||
### | ### 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 == <!--T:131--> | ||
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 [https://wiki.centos.org/HowTos/SELinux SELinux]. | |||
= | =Após a criação do banco de dados= <!--T:35--> | ||
== | ==Página em branco após a criação do banco de dados== <!--T:36--> | ||
=== | ===Sintomas=== <!--T:37--> | ||
* LimeSurvey | * 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 | * 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=== <!--T:38--> | ||
<!--T:39--> | <!--T:39--> | ||
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== <!--T:40--> | ||
=== | ===Sintomas=== <!--T:41--> | ||
* LimeSurvey | * 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: | ||
<!--T:42--> | <!--T:42--> | ||
Line 132: | Line 132: | ||
<!--T:43--> | <!--T:43--> | ||
'' | ''Nota:'' o número da linha pode ser diferente dependendo da versão do LimeSurvey. | ||
=== | ===Solução=== <!--T:44--> | ||
<!--T:45--> | <!--T:45--> | ||
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--> | ||
'' | ''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== <!--T:48--> | ||
=== | ===Sintomas=== <!--T:49--> | ||
* LimeSurvey | * 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 | * $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: ()+ | ||
<!--T:50--> | <!--T:50--> | ||
'' | ''Nota:'' Outros caracteres também podem induzir o mesmo comportamento. | ||
=== | ===Solução=== <!--T:51--> | ||
<!--T:52--> | <!--T:52--> | ||
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= <!--T:123--> | ||
<!--T:124--> | <!--T:124--> | ||
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
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):
- Use o terminal (como super usuário) e digite: yum install php-mbstring
- Certifique-se de atualizar /etc/php.ini para atualizar e descomentar os vários parâmetros mbstring
- 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".'
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
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.