Atualizar a partir de uma versão anterior

Páginas adicionais:{toc}

Antes de começar...

... leia isto porque é muito importante: Faça sempre uma cópia de segurança dos ficheiros e da base de dados da sua instalação atual!

Pode fazê-lo utilizando uma ferramenta de administração de bases de dados como o phpMyAdmin e um gestor de ficheiros! Se não sabe como fazê-lo, não deve prosseguir e deve pedir ajuda a alguém que saiba.

Recomendação para utilizar o ComfortUpdate

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

Instruções gerais de atualização

Estas instruções são genéricas e aplicam-se da versão 2.x ou superior a qualquer versão posterior.

Siga estes passos:

1. Termine a sessão na administração
2. Faça uma cópia de segurança dos seus ficheiros e da base de dados
3. Elimine todos os ficheiros/pastas antigos, exceto:
   1. /application/config/security.php - Importante!! Esta é a chave de todos os dados encriptados no LimeSurvey (versão 4 e posteriores)
   2. /application/config/config.php;
   3. a pasta /upload
4. Copie os novos ficheiros do novo pacote do LimeSurvey para a localização existente.
5. Agora limpe a 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 da base de dados, ser-lhe-á pedido que a confirme.
7. Concluído!

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

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

Atualizar através da CLI

Pode atualizar a base de dados através da CLI do PHP: php application/commands/console.php updatedb. Isto permite configurar um sistema de atualização automática através da linha de comandos (por exemplo, num crontab), embora não seja recomendado.

Falha na atualização da base de dados após atualização manual/ComfortUpdate

Por vezes, mesmo que tenha feito tudo corretamente, as coisas não correm como deveriam durante a atualização da base de dados. Isto pode acontecer por vários motivos: versões diferentes da base de dados, formatos ou conteúdos de dados inesperados, configurações pouco habituais ou qualquer outra coisa que não tenha surgido nos nossos testes (sim, testamos muito!)

Se ocorrer um erro durante a atualização da base de dados e a sua instância do LimeSurvey ficar num estado inutilizável, deve voltar à versão anterior. Isto pressupõe que ainda tem a cópia de segurança da base de dados e dos ficheiros, quer da sua cópia de segurança regular, quer da criada pelo ComfortUpdate.

Execute os seguintes passos:

• Faça uma cópia de segurança da pasta e da base de dados existentes do LimeSurvey (sim, outra vez - chamaremos a esta a 2.ª cópia de segurança)
• Restaure os ficheiros para a pasta existente (basta sobrescrevê-los) a partir da cópia de segurança original (1.ª).
• Elimine a base de dados antiga e restaure a base de dados a partir da cópia de segurança original (1.ª).

É tudo. Tudo deverá voltar ao normal.

Uma nota sobre a comunicação deste problema:

Se encontrar um problema deste tipo, comunique-o sempre no nosso sistema de registo de erros em https://bugs.limesurvey.org

Um erro que não é comunicado é um erro que não é corrigido. Não confie apenas em que outras pessoas o comuniquem. Se verificar que o erro já foi comunicado, também pode ajudar a aumentar a prioridade do erro marcando-o como 'Yes, this bug affects me' no sistema de registo de erros.

FAQ

Posso atualizar mesmo que tenha inquéritos ativos?

Sim, pode. Podem ser mencionadas exceções nas instruções detalhadas acima. Recomendamos vivamente que teste os seus inquéritos após a atualização, para verificar se os seus modelos de design continuam a funcionar corretamente.

Como converter ficheiros de estrutura de inquérito *.sql/*.csv para a versão mais recente do LimeSurvey?

Instale a versão 1.50, importe o ficheiro e exporte a estrutura do inquérito para o formato .csv mais recente. Depois 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.