FAQ de instalação

Conteúdo:

Instalação no seu computador

O LimeSurvey pode ser instalado no seu computador com MAMP/XAMPP ou qualquer outro sistema. Tenha em conta que o seu computador não é um servidor web - não está acessível através da web a nenhum outro utilizador.

Para tornar o seu inquérito acessível a outros utilizadores através da web, tem de:

• ter um servidor ou um espaço web de um fornecedor de alojamento
• ou pesquisar um fornecedor de alojamento especializado em LimeSurvey

Início da instalação

Como posso criar uma base de dados e um utilizador no MySQL com acesso à linha de comandos?

Tem de introduzir os comandos abaixo no seu 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>@localhost = 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';

No terminal, <your_database_name>, <your_database_username> e <your_database_password> têm de ser substituídos pelos valores correspondentes/pretendidos.

E se não conseguir criar uma base de dados através de um script?

Normalmente, o script cria uma nova base de dados e, de seguida, a estrutura de tabelas. No entanto, se o seu servidor/ISP não lhe der direitos de administrador para criar uma nova base de dados no MySQL, terá de contactar o administrador do servidor para que a base de dados necessária seja criada (ou criá-la você mesmo, caso receba as permissões necessárias). A base de dados vazia recém-criada deve incluir os direitos de acesso adequados (ou seja: leitura/escrita/criação). Depois, poderá iniciar a instalação do LimeSurvey, que criará as tabelas na base de dados recém-criada.

Página em branco ao aceder à página de instalação

Este problema não ocorre na instalação do LimeSurvey, mas sim na instalação do PHP.

• Verifique se tem o módulo PHP do MySQL (php-mysql) instalado.
• Verifique se a sua instalação do PHP está a carregar o ficheiro PHP.ini que está a modificar e não a analisar outros ficheiros PHP.INI no seu sistema.
• Verifique a localização e as permissões da seguinte definição no seu PHP.ini:

upload_tmp_dir="/temp"

session.save_path="/temp"

• Verifique se o seu servidor executa uma Versão PHP adequada.

Mensagens de erro devido a recursos inexistentes

Por vezes, os ficheiros não são carregados corretamente ou ficam danificados durante o processo de carregamento. Isto origina várias mensagens de erro diferentes. A maioria refere-se a um ficheiro ou a uma função dentro de um ficheiro que não pode ser encontrado.

Solução: Volte a carregar todos os ficheiros utilizando o modo binário do seu programa de FTP.

Página de requisitos

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

A biblioteca mbstring é uma biblioteca PHP que consegue converter conjuntos de caracteres de um idioma para outro. É necessária para executar o LimeSurvey. Para verificar se já está instalada, abra o seguinte URL num navegador:

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

Serão apresentadas muitas informações. Pesquise a cadeia de caracteres 'mbstring' na secção Configuração. Se encontrar a secção mbstring, está tudo em ordem e pode continuar com a instalação do LimeSurvey!

Se não encontrar a secção mbstring, poderá ter um problema. Existem três cenários possíveis:

• Se for o servidor do seu fornecedor de alojamento, peça a ativação dessa extensão no PHP ou mais informações sobre como a pode ativar - se tiver um bom painel de administração para o seu servidor, poderá conseguir ativá-la você mesmo
• Se for o seu próprio servidor Linux, poderá ter de recompilar o PHP e incluir a biblioteca mbstring. Pergunte aos especialistas em Linux como o fazer. No entanto, pode instalá-la através do gestor de pacotes do Linux, que atualmente está disponível em quase todas as distribuições Linux
  • Se utilizar uma versão do Linux que suporte 'yum' (CentOS, RedHat, Fedora)...
    • ...utilize o terminal (como superutilizador) e escreva: yum install php-mbstring
    • ...certifique-se de que atualiza o ficheiro /etc/php.ini e remove o comentário dos vários parâmetros mbstring
    • ...certifique-se de que reinicia o apache após a instalação: /etc/init.d/httpd restart
• Se for o seu próprio servidor Windows, pesquise php.ini no seu sistema, abra-o com um editor e pesquise mbstring. Muito provavelmente, a linha que contém a cadeia de caracteres está comentada com um ponto e vírgula. Elimine o ponto e vírgula, guarde e reinicie o servidor web

Bloqueado na verificação das permissões do sistema de ficheiros

Se o SELinux estiver ativado (principalmente no CentOS), poderá receber um erro a indicar que as permissões do sistema de ficheiros não estão corretas, mesmo que a lista de pastas esteja vazia. O SELinux impede a escrita, mesmo que as permissões sejam, por exemplo, 777 ou 755. Para configurar corretamente o SELinux no seu servidor, consulte a documentação do SELinux.

Após a criação da base de dados

Página em branco após a criação da base de dados

Sintomas

• O LimeSurvey está instalado corretamente e a base de dados foi criada, mas em vez da página de administração, obtém uma página vazia
• O registo do servidor web mostra "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"

Solução

Isto está provavelmente relacionado com uma definição incorreta de $rooturl ou $rootdir em config.php. O ficheiro config.php tenta definir $rootdir corretamente chamando dirname('''FILE'''). Embora isto normalmente funcione, pode falhar quando o LimeSurvey está instalado na pasta pessoal de um utilizador ou na pasta public_html e a pasta pessoal está montada via NFS. Para definir $rootdir manualmente (a sua shell ou o comando pwd poderá mostrar um caminho como /disks/hostname/home/username/public_html/limesurvey), tente utilizar /home/username/public_html/limesurvey.

Ao aceder à página de administração, o navegador fica a carregar e acaba por não a mostrar

Sintomas

• O LimeSurvey está instalado corretamente e a base de dados foi criada. No entanto, ao aceder à página de administração, o navegador fica a carregar e acaba por não mostrar a página
• Ao verificar o registo de acessos do servidor web, o seu tamanho tornou-se muito grande (em alguns casos, mais de 2 GB)
• No registo de acessos, esta mensagem preenche o registo:

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

O número da linha pode ser diferente consoante a sua versão do LimeSurvey.

Solução

Isto pode ser causado pela definição mbstring.func_overload. Altere a seguinte definição no ficheiro php.ini:

mbstring.func_overload = 0

Isto significa que não há sobrecarga de funções. Consulte o manual do PHP para esta definição: Função de sobrecarga (Function Overloading Feature).

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

Sintomas

• O LimeSurvey está instalado corretamente e a base de dados foi criada. Mas, ao ser redirecionado para a página de administração, o navegador apresentou o erro indicado.
• $rootdir e $rooturl estão corretamente definidos em config.php.
• O nome do caminho no disco da pasta de instalação do LimeSurvey inclui um dos seguintes caracteres: '(',')' ou '+'.

  Outros caracteres também podem provocar o mesmo comportamento.

Solução

Mova/mude o nome da pasta de instalação do LimeSurvey de modo que o nome do caminho não inclua nenhum dos seguintes caracteres: '(',')' ou '+'.

Após a instalação

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