Mudanças entre as edições de "Atualizações de versão - SEER"
Ronniebrito (disc | contribs) (→Como faço para atualizar o SEER versão 2.x?) |
Ronniebrito (disc | contribs) (→Como faço para atualizar o SEER versão 2.x?) |
||
Linha 15: | Linha 15: | ||
Para atualizar o sistema baixando o código fonte completo da nova versão, siga os seguintes passos: | Para atualizar o sistema baixando o código fonte completo da nova versão, siga os seguintes passos: | ||
− | + | # Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante) | |
− | + | # Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao | |
sistema | sistema | ||
− | + | # 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. | Web do servidor) e do sistema SEER. | ||
− | + | # Baixe a nova versão e descompacte no local apropriado. | |
− | + | # Altere as permissões de dono (chown) e acesso (chmod) da pasta descompactada | |
− | + | # Altere o arquivo ojs2/config.inc.php da instalação anterior, tornando-a indisponível | |
− | + | # Defina a variável installed = Off | |
− | + | # Altere o arquivo ojs2/config.inc.php da nova versão | |
− | + | ## a URL padrão do sistema | |
− | + | ## os dados de acesso ao banco de dados | |
− | + | ## o tipo de criptografia (por padrão é MD5, mas recomenda-se utilizar SHA1, este valor deve ser igual ao da instalação inicial) | |
− | + | ## codificação da conexão do banco | |
− | + | ## codificação de caracteres do cliente | |
− | + | ## o endereço da pasta de submissões | |
− | + | ## outras configurações disponíveis, como SMTP e outras | |
− | + | ## mantenha a variável installed = Off | |
− | + | ||
− | + | # Acesse, no navegador de sua preferência (recomenda-se o Firefox), a página da nova instalação | |
+ | # 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. | nova versão com o nome da versão anterior original. | ||
− | + | # Clique no link "Atualizar versão", no início do formulário e siga o resto das instruções | |
− | + | # 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, | 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. | 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 | 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. | comando, e usando o comando DIFF para comparar versões do sistema. | ||
Linha 45: | Linha 48: | ||
Não é uma opção recomendada, principalmente com instalações com muitas revistas hospedadas ou com grande volume | 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). | 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, | 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. | essa ferramenta é executada como usuário root, mas seu dono pode ser alterado. | ||
Linha 54: | Linha 57: | ||
servidor para que seja possível executá-la a. | servidor para que seja possível executá-la a. | ||
Após instalada a ferramenta PHP CLI, siga os seguintes passos: | Após instalada a ferramenta PHP CLI, siga os seguintes passos: | ||
− | + | # Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante) | |
− | + | # Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao | |
sistema | sistema | ||
− | + | # Altere as permissões da pasta do SEER para o usuário que executa o PHP CLI (ex.: chown -Rf dono:grupo ojs2) | |
− | + | # Execute o comando #bash/: php ojs2/tools/upgrade.php para exibir a lista de comandos disponíveis | |
− | + | ## upgrade.php check para verificar a versão | |
− | + | ## upgrade.php upgrade pretend para testar a atualização, sem realizá-la | |
− | + | ## upgrade.php upgrade para executar a atualização do banco de dados | |
− | + | ## upgrade.php patch para baixar o patch de atualização e aplicá-lo, atualizando o código fonte | |
− | + | ## upgrade.php download para baixar a nova versão (não descompacta ou instala a nova versão completa!) | |
− | + | ## 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) | a atualização do código fonte) | ||
− | + | # Execute os comandos na seguinte ordem: | |
− | + | ## 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) | execução de qualquer comando) | ||
− | + | ## 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) | realizado alterações no código fonte (arquivos de estilo e templates, por exemplo) | ||
− | + | ## execute o comando "upgrade" para atualizar o o banco de dados | |
− | + | ## execute o comando "check" novamente para verificar a situação do sistema após realizar a atualização |
Edição atual tal como às 12h13min de 20 de outubro de 2014
Atualização da versão OJS 1.x.x para a 2.4.2
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:
- Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante)
- Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao
sistema
- 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.
- Baixe a nova versão e descompacte no local apropriado.
- Altere as permissões de dono (chown) e acesso (chmod) da pasta descompactada
- Altere o arquivo ojs2/config.inc.php da instalação anterior, tornando-a indisponível
- Defina a variável installed = Off
- Altere o arquivo ojs2/config.inc.php da nova versão
- a URL padrão do sistema
- os dados de acesso ao banco de dados
- o tipo de criptografia (por padrão é MD5, mas recomenda-se utilizar SHA1, este valor deve ser igual ao da instalação inicial)
- codificação da conexão do banco
- codificação de caracteres do cliente
- o endereço da pasta de submissões
- outras configurações disponíveis, como SMTP e outras
- mantenha a variável installed = Off
- Acesse, no navegador de sua preferência (recomenda-se o Firefox), a página da nova instalação
- 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.
- Clique no link "Atualizar versão", no início do formulário e siga o resto das instruções
- 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:
- Renomeie o arquivo ojs2/index.php para index.bkup.php (ou semelhante)
- Crie um arquivo ojs2/index.php, com os dizeres "Sistema em manutenção" (ou semelhante), impedindo o acesso ao
sistema
- Altere as permissões da pasta do SEER para o usuário que executa o PHP CLI (ex.: chown -Rf dono:grupo ojs2)
- Execute o comando #bash/: php ojs2/tools/upgrade.php para exibir a lista de comandos disponíveis
- upgrade.php check para verificar a versão
- upgrade.php upgrade pretend para testar a atualização, sem realizá-la
- upgrade.php upgrade para executar a atualização do banco de dados
- upgrade.php patch para baixar o patch de atualização e aplicá-lo, atualizando o código fonte
- upgrade.php download para baixar a nova versão (não descompacta ou instala a nova versão completa!)
- 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)
- Execute os comandos na seguinte ordem:
- 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)
- 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)
- execute o comando "upgrade" para atualizar o o banco de dados
- execute o comando "check" novamente para verificar a situação do sistema após realizar a atualização