Mudanças entre as edições de "Atualizações de versão - SEER"
Ronniebrito (disc | contribs) |
Ronniebrito (disc | contribs) (→Como faço para atualizar o SEER versão 2.x?) |
||
Linha 1: | Linha 1: | ||
== Atualização da versão OJS 1.x.x para a 2.4.2 == | == 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? == | ||
+ | |||
+ | 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) | ||
+ | - 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). | ||
+ | {mospagebreak title=Atualizando via linha de comando} | ||
+ | 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 sitsema após realizar a atualização |
Edição das 12h10min 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) - 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). {mospagebreak title=Atualizando via linha de comando} 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 sitsema após realizar a atualização