Atualizando a partir de uma versão anterior

Páginas adicionais:{toc}

Antes de começar...

... leia isto, pois é muito importante: Sempre faça backup dos arquivos e do banco de dados da sua instalação atual!

Você pode fazer isso usando uma ferramenta de administração de banco de dados, como o phpMyAdmin, e um gerenciador de arquivos! Se você não souber como fazer isso, não prossiga e peça ajuda a alguém que saiba.

Recomendação: usar o ComfortUpdate

A maneira mais fácil/segura de atualizar é usar o nosso serviço ComfortUpdate.

Instruções gerais de atualização

Estas são instruções genéricas e se aplicam da versão v2.x ou mais recente a qualquer versão posterior.

Siga estas etapas:

1. Saia da administração
2. Faça backup dos seus arquivos e do banco de dados
3. Exclua todos os arquivos/pastas antigos, exceto:
   1. /application/config/security.php - Importante!! Esta é a chave para todos os dados criptografados no LimeSurvey (versão 4 e posteriores)
   2. /application/config/config.php;
   3. diretório /upload
4. Copie os novos arquivos do novo pacote do LimeSurvey para o local existente.
5. Agora limpe o cache e os cookies do seu navegador.
6. Abra a página de administração no seu navegador (por exemplo, https://www.example.com/limesurvey/admin). Se for necessária uma atualização do esquema do banco de dados, você será solicitado a confirmá-la.
7. Pronto!

Instruções de atualização específicas para atualizações de versões principais

• Atualização da versão 5 para a 6
• Atualização da versão 6 para a 7

Atualizando por CLI

Você pode atualizar o banco de dados por meio da CLI do PHP: php application/commands/console.php updatedb. Isso permite configurar um sistema de atualização automática via linha de comando (por exemplo, em um crontab), embora isso não seja recomendado.

Falha na atualização do banco de dados após atualização manual/ComfortUpdate

Às vezes, mesmo que você tenha feito tudo corretamente, as coisas não funcionam como deveriam durante a atualização do banco de dados. Isso pode acontecer por vários motivos: versões diferentes de banco de dados, formatos ou conteúdos de dados inesperados, configurações incomuns ou qualquer outra coisa que não tenha aparecido em nossos testes (sim, nós testamos bastante!)

Se ocorrer um erro durante a atualização do banco de dados e a sua instância do LimeSurvey ficar inutilizável, você vai querer voltar à versão anterior. Isso pressupõe que você ainda tenha o backup do banco de dados e dos arquivos, seja do seu backup regular ou do criado pelo Comfortupdate.

Execute as seguintes etapas:

• Faça backup do diretório e do banco de dados existentes do LimeSurvey (sim, novamente - vamos chamá-lo de 2º backup)
• Restaure os arquivos no diretório existente (basta sobrescrevê-los) a partir do backup original (1º).
• Exclua o banco de dados antigo e restaure o banco de dados a partir do backup original (1º).

Pronto. Tudo deve voltar ao normal.

Uma observação sobre como relatar este problema:

Se você se deparar com um problema como este, relate-o sempre em nosso rastreador de bugs em https://bugs.limesurvey.org

Um bug não relatado é um bug não corrigido. Não conte apenas com o relato de outras pessoas. Se você perceber que o bug já foi relatado, também pode ajudar a aumentar a prioridade dele marcando 'Yes, this bug affects me' (Sim, este bug me afeta) no rastreador de bugs.

FAQ

Posso atualizar mesmo que eu tenha questionários ativos?

Sim, você pode. Exceções podem ser mencionadas nas instruções detalhadas acima. Recomendamos fortemente testar os seus questionários após a atualização para verificar se os seus templates de design ainda funcionam corretamente.

Como converter arquivos de estrutura da pesquisa *.sql/*.csv para a versão mais recente do LimeSurvey?

Instale a versão 1.50, importe o arquivo e exporte a estrutura da pesquisa para o formato .csv mais recente. Em seguida, instale a versão 2.x mais recente, importe o formato .csv e exporte-o para o formato .lss atual.

Survey theme incompatibility

With certain major version updates any custom survey themes will not be compatible, anymore:

• Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
• Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

Error "Multiple primary key defined" when updating MySQL database

If you encounter this error, please check the setting sql_generate_invisible_primary_key in your MySQL server variables. This is most likely set to ON, but should be set to OFF. Then restore your database from the backup (as explained above) and try again.