Atualizações de versão - SEER

Como faço para atualizar o SEER versão 2.x?

Como faço para atualizar o SEER versão 2.x? A atualização da versão 2 é, normalmente, um processo simples, que envolve dois passos: a atualização do código fonte e a atualização do banco de dados.

Não afeta o conteúdo armazenado no banco de dados, nem os cadastros dos usuários.

IMPORTANTE: Caso ocorram problemas durante a atualização, indepentemente do método usado, deve-se restaurar o sistema ao ponto anterior à atualização, pois não é possível identificar onde ocorreram problemas. Isto é, devem ser restaurarados o banco de dados e o código do sistema para a versão anterior. Para atualizar uma versão 2.x para uma versão mais atual há vários procedimentos que podem ser utilizados. Nas próximas páginas, serão detalhados cada um dos processos.

Para atualizar o sistema baixando o código fonte completo da nova versão, siga os seguintes passos:

1. Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante)
2. Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao

sistema

1. Faça (sempre, com regularidade) um backup do banco de dados, da pasta de submissões (normalmente fora da pasta

Web do servidor) e do sistema SEER.

1. Baixe a nova versão e descompacte no local apropriado.
2. Altere as permissões de dono (chown) e acesso (chmod) da pasta descompactada
3. Altere o arquivo ojs2/config.inc.php da instalação anterior, tornando-a indisponível
4. Defina a variável installed = Off
5. Altere o arquivo ojs2/config.inc.php da nova versão
   1. a URL padrão do sistema
   2. os dados de acesso ao banco de dados
   3. o tipo de criptografia (por padrão é MD5, mas recomenda-se utilizar SHA1, este valor deve ser igual ao da instalação inicial)
   4. codificação da conexão do banco
   5. codificação de caracteres do cliente
   6. o endereço da pasta de submissões
   7. outras configurações disponíveis, como SMTP e outras
   8. mantenha a variável installed = Off

1. Acesse, no navegador de sua preferência (recomenda-se o Firefox), a página da nova instalação
2. Para facilitar, renomeie a pasta da versão anterior (ex.: /var/www/minharevista_bkup) e altere o nome da pasta da

nova versão com o nome da versão anterior original.

1. Clique no link "Atualizar versão", no início do formulário e siga o resto das instruções
2. Teste o sistema para verificar se tudo está ok.

Pode ser necessário alterar os arquivos de estilo (CSS), além de outras pastas criadas para imagens, por exemplo, para reproduzir o layout da versão anterior.

Caso tenha realizado alterações no código fonte do sistema, recomenda-se proceder através da atualização via linha de comando, e usando o comando DIFF para comparar versões do sistema. IMPORTANTE: Esta opção de atualização deve ser usada apenas quando não é possível o acesso via linha de comando. Não é uma opção recomendada, principalmente com instalações com muitas revistas hospedadas ou com grande volume de dados, pois há limitações de tempo de execução de scripts via HTTP (timeout do Apache e do próprio navegador).

Para atualizar via linha de comando, é necessário que a ferramenta PHP CLI esteja instalada no servidor. Geralmente, essa ferramenta é executada como usuário root, mas seu dono pode ser alterado. O servidor precisará de acesso à internet para poder baixar os arquivos necessários para a atualização, caso contrário, será necessário baixar os arquivos e executar alguns comandos manualmente. IMPORTANTE: Embora este seja o método recomendado para atualização do sistema, por ser mais rápido e com possibilidade de verificar o andamento e ser mais detalhado, depende das permissões de acesso e configurações do servidor para que seja possível executá-la a. Após instalada a ferramenta PHP CLI, siga os seguintes passos:

1. Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante)
2. Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao

sistema

1. Altere as permissões da pasta do SEER para o usuário que executa o PHP CLI (ex.: chown -Rf dono:grupo ojs2)
2. Execute o comando #bash/: php ojs2/tools/upgrade.php para exibir a lista de comandos disponíveis
   1. upgrade.php check para verificar a versão
   2. upgrade.php upgrade pretend para testar a atualização, sem realizá-la
   3. upgrade.php upgrade para executar a atualização do banco de dados
   4. upgrade.php patch para baixar o patch de atualização e aplicá-lo, atualizando o código fonte
   5. upgrade.php download para baixar a nova versão (não descompacta ou instala a nova versão completa!)
   6. upgrade.php upgrade para atualizar o banco de dados, após atualizar o código fonte (esta opção deve ser executada após

a atualização do código fonte)

1. Execute os comandos na seguinte ordem:
   1. teste a situação do sistema usando o comando "check" (pode-ser usado para verificar o andamento do sistema após a

execução de qualquer comando)

1. 1. execute o comando "patch" para atualizar o código fonte de forma mais rápida e com menos impacto caso tenha

realizado alterações no código fonte (arquivos de estilo e templates, por exemplo)

1. 1. execute o comando "upgrade" para atualizar o o banco de dados
   2. execute o comando "check" novamente para verificar a situação do sistema após realizar a atualização