Mudanças entre as edições de "Upgrade de versões"

De IBICT
Ir para: navegação, pesquisa
Linha 2: Linha 2:
  
  
* Saber exatamente quais foram os arquivos alterados nas mudanças de layout executadas pelo usuário;
+
* Saber exatamente quais arquivos de layout foram alterados pelo usuário;
  
* Casar novas funcionalidades com o layout antigo (por exemplo a busca facetada);
+
* Adaptar novas funcionalidades com o layout (por exemplo: busca facetada);
  
* Manter as estatísticas de acesso antigas;
+
* Manter as estatísticas;
  
* Atualizar a base de dados sem corrompê-la;
+
* Atualizar a base de dados;
  
 
* Migrar a assetstore (pasta que contem os documentos);
 
* Migrar a assetstore (pasta que contem os documentos);
  
* Implementar possíveis alterações de código das bibliotecas Java, que usuário efetuou.
+
* Implementar possíveis alterações de código feitas pelo usuário.
  
 
   
 
   
Este tutorial concentra esforços no sentido de contornar os quatro primeiros tópicos, já que o último envolveria um conhecimento mais amplo da linguagem de programação Java, o que foge do escopo planejado. Também há uma diferença entre os procedimentos descritos no [https://github.com/DSpace/DSpace/raw/master/dspace/docs/DSpace-Manual.pdf manual oficial do DSpace 3.x] e o que aqui se recomenda. De fato, entende-se que há uma maior segurança em realizar uma instalação '''clean''' da nova versão e aplicar nela as configurações particulares da antiga. Essa tarefa gera também uma melhor compreensão do processo de atualização. Sem levar em conta que, dessa forma, é possível estabelecer um procedimento genérico de migração de uma versão 1.x para a 3.x.
+
Este ''passo-a-passo'' se concentra nos quatro primeiros tópicos descritos, já que o último foge do escopo de configuração e está mais relacionado às técnicas de programação JAVA. uma diferença entre os procedimentos descritos no [https://github.com/DSpace/DSpace/raw/master/dspace/docs/DSpace-Manual.pdf manual oficial do DSpace 3.x] e o que aqui se apresenta. De fato, entende-se que existe maior segurança em realizar uma instalação '''clean''' da nova versão e aplicar nela as configurações particulares da antiga. Essa tarefa gera também uma melhor compreensão do processo de atualização, e é possível estabelecer um procedimento genérico de migração de uma versão 1.x (com x >= 6) para a 3.x.
  
 
{{Nota|O primeiro passo é a [http://devds-01.ibict.br/Dwiki/index.php/Instala%C3%A7%C3%A3o_do_DSpace_3.x instalação] limpa, em uma '''pasta''' e '''base''' de dados diferente da utilizada para versão antiga.}}
 
{{Nota|O primeiro passo é a [http://devds-01.ibict.br/Dwiki/index.php/Instala%C3%A7%C3%A3o_do_DSpace_3.x instalação] limpa, em uma '''pasta''' e '''base''' de dados diferente da utilizada para versão antiga.}}

Edição das 15h43min de 30 de agosto de 2013

Realizar upgrade de versões não é uma tarefa simples e direta. Há alguns dificultadores, os mais comuns são:


  • Saber exatamente quais arquivos de layout foram alterados pelo usuário;
  • Adaptar novas funcionalidades com o layout (por exemplo: busca facetada);
  • Manter as estatísticas;
  • Atualizar a base de dados;
  • Migrar a assetstore (pasta que contem os documentos);
  • Implementar possíveis alterações de código feitas pelo usuário.


Este passo-a-passo se concentra nos quatro primeiros tópicos descritos, já que o último foge do escopo de configuração e está mais relacionado às técnicas de programação JAVA. Há uma diferença entre os procedimentos descritos no manual oficial do DSpace 3.x e o que aqui se apresenta. De fato, entende-se que existe maior segurança em realizar uma instalação clean da nova versão e aplicar nela as configurações particulares da antiga. Essa tarefa gera também uma melhor compreensão do processo de atualização, e é possível estabelecer um procedimento genérico de migração de uma versão 1.x (com x >= 6) para a 3.x.

Notepad.gif NOTA: O primeiro passo é a instalação limpa, em uma pasta e base de dados diferente da utilizada para versão antiga.

Por exemplo pode-se utilizar como pasta base o nome dspace-3.x-base e como base de dados dspace3x, onde x representa o número correspondente à versão.

Versão 1.x para a 3.x

Aqui toma-se como pressuposto que a instalação antiga foi efetuada na pasta dspace-1.x-base e tomou como base de dados dspace1x.

Warning.gif Atenção: Antes de qualquer outra ação deve-se realizar um backup da base de dados e da assetstore antiga. A aplicação pode receber um nome temporário novo, como por exemplo: dspace-3.x-jspui


Notepad.gif NOTA: Dependendo do tamanho da base de dados e, principalmente, da(s) pasta(s) assetstore, o backup e restore pode ser bastante demorado, podendo durar muitas horas.


Backup

Para o backup da base de dados basta que se execute o comando:

pg_dump dspace1x > bkp_dspace1x_DDMMAA.sql


Já para o backup da(s) pasta(s) assetstore, basta que se execute o comando, para cada pasta utilizada (em geral só se utiliza uma única pasta, que deve estar dentro da pasta base de instalação. Contudo para se ter certeza de qual(is) pasta(s) é(são) utiliza(s), deve-se verificar no arquivo dspace-1.x-base/config/dspace.cfg os parâmetros assetstore.dir, assetstore.dir.1 e assetstore.dir.2):

tar -cvzf bkp_assetstore_DDMMAA.tar.gz [caminho-da-pasta-assetstore]