Mudanças entre as edições de "Atualizações de versão - SEER"

De IBICT
Ir para: navegação, pesquisa
(Criou página com '== Atualização da versão 1.x.x para a 2.4.2 ==')
 
(Como faço para atualizar o SEER versão 2.x?)
 
(3 edições intermediárias de 2 usuários não apresentadas)
Linha 1: Linha 1:
== Atualização da versão 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?
 +
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

Edição atual tal como às 11h13min 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:

  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. 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. 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