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

De IBICT
Ir para: navegação, pesquisa
(Como faço para atualizar o SEER versão 2.x?)
(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)
+
# 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
+
# 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
+
# 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.
+
# Baixe a nova versão e descompacte no local apropriado.
- Altere as permissões de dono (chown) e acesso (chmod) da pasta descompactada
+
# 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
+
# Altere o arquivo ojs2/config.inc.php da instalação anterior, tornando-a indisponível
- Defina a variável installed = Off
+
# Defina a variável installed = Off
- Altere o arquivo ojs2/config.inc.php da nova versão
+
# Altere o arquivo ojs2/config.inc.php da nova versão
- a URL padrão do sistema
+
## a URL padrão do sistema
- os dados de acesso ao banco de dados
+
## os dados de acesso ao banco de dados
- o tipo de criptografia (por padrão é MD5, mas recomenda-se utilizar SHA1)
+
## 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 da conexão do banco
- codificação de caracteres do cliente
+
## codificação de caracteres do cliente
- o endereço da pasta de submissões
+
## o endereço da pasta de submissões
- outras configurações disponíveis, como SMTP e outras
+
## outras configurações disponíveis, como SMTP e outras
- mantenha a variável installed = Off
+
## 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
+
# 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
+
# 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.
+
# 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).
{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,
 
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)
+
# 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
+
# 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)
+
# 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
+
# 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 check para verificar a versão
- upgrade.php upgrade pretend para testar a atualização, sem realizá-la
+
## 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 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 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 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
+
## 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:
+
# 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
+
## 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
+
## 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 "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
+
## 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:

  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