Upgrade versão 5.x

De IBICT
Edição feita às 10h47min de 5 de setembro de 2016 por Washington (disc | contribs)

(dif) ← Edição anterior | ver versão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

A atualização do DSpace para a versão 5.x se tornou relativamente simples devido a uma série de automaticidades desenvolvidas. Siga os passos a seguir e a atualização (inclui a migração dos dados e das estatísticas) deve ocorrer sem problemas.

Índice

Backups

Realize backup dos seguintes parâmetros do seu DSpace:

  • Banco de dados:
pg_dump -U [database-user] -f [backup-file-location] [database-name]
  • Pasta Assetstore: Localizado geralmente em: /dspace-base/assetstore;
  • Configurações: Faça backup de todas as configurações do seu DSpace, tais configurações estão localizadas geralmente em /dspace-base/config;
  • Customizações: Caso existam customizações de sua instituição, é importante se atentar a essas também (customizações como: layout e scripts por exemplo);
  • Estatísticas: Faça backup da seguinte pasta: /dspace-base/solr/statistics.

Atualizar e/ou Baixar requisitos para utilizar DSpace 5.x (caso necessário)

  • Java 7 (Oracle ou preferencialmente OpenJDK)
  • Apache Maven 3.0.5 ou versão mais atual
  • Apache Ant 1.8 ou versão mais atual
  • Database
    • PostgreSQL 9.0 ou versão mais atual
  • Tomcat 7 or above

Baixando e instalando normalmente

Acesse o seguinte link de nossa wiki e realize o download do DSpace que sua gestão decidir.

build.properties

Variáveis Configurações
dspace.install.dir=/dspace-base Diretório destino de instalação;
dspace.hostname = localhost Nome do servidor na rede;
dspace.baseUrl = http://localhost:8080 Endereço do servidor na rede;
dspace.url = ${dspace.baseUrl} URL da aplicação na internet;
dspace.name = Dspace Nome do Repositório;
db.url=jdbc:postgresql://localhost:5432/dspace;

db.username=dspace

db.password=dspace

Endereço do servidor SGBD do banco de dados e usuário e senha deste. Recomenda-se alterar somente o password;
mail.server = smtp.example.com Servidor de email da instituição, para que o DSpace envie mensagens automáticas;
mail.server.username=

mail.server.password=

Usuário e senha do servidor de email;
mail.from.address Endereço de email do remetente das mensagens;
mail.feedback.recipient = Endereço que receberá as mensagens de feedback dos usuários;
mail.admin = Email do administrador do repositório;
mail.alert.recipient= Email que receberá os erros de sistema;
mail.registration.notify= Email que receberá a notificação de registros de usuários;
mail.helpdesk = Email do responsável por gerenciar as solicitações de cópia de documentos embargados ou de acesso restrito;
handle.prefix = 123456789 Prefixo identificador da instancia do DSpace;
Servidor de email da instituição, para que o DSpace envie mensagens automáticas;

Importante

Quaisquer configurações inseridas nesse arquivo serão automaticamente copiadas para o arquivo dspace.cfg, então é sempre bom manter consonância de algumas configurações com o dspace.cfg atual de seu repositório.

Compilando o DSpace

Entre na pasta dspace-fonte

cd /dspace-fonte

E realize o seguinte passo

/home/dspace/apache-maven-x.x.x/bin/mvn -U clean package

Após aproximadamente 30 min, o sistema deve responder com um log na tela, e ao final a mensagem BUILD SUCCESSFUL.

    • Caso não apareça a mensagem BUILD SUCCESSFUL, um erro que pode ocorrer nesse momento, é erro de alocação de memória: java.lang.OutOfMemoryError: Java heap space. A solução sugerida nesse manual é a execução da seguinte linha de código (irá permitir que o Maven acesse mais memória da máquina):
echo $MAVEN_OPTS
-Xms64m -Xmx512m -Dmaven.surefire.debug=-Xmx512m

Valores acima podem ser alterados de acordo com as necessidades da máquina.

  • Caso o tomcat esteja iniciado, é necessário pará-lo para o seguinte passo..!

Atualizando seu repositório

Entre na pasta dspace-installer

cd /dspace-fonte/dspace/target/dspace-installer

E realize o seguinte passo:

/home/dspace/apache-ant-x.x.x/bin/ant update

Tomcat

Por precaução, realize o backup do conteúdo da pasta webapps do tomcat também.

Tomcat

Copie o conteúdo atualizado para o tomcat:

cp -R dspace-base/webapps/* tomcat/webapps/

Atualizando o banco de dados

Verifique a versão do banco de dados pelo seguinte comando:

dspace-base/bin/dspace database info

Caso a versão não esteja atualizada, realize o seguinte comando:

dspace-base/bin/dspace database migrate


Indexando os dados no DSpace 5.x

Ao realizar o ant update, alguns (ou todos) os registros ficarão nomeados como: bi_.. (BI = Browse Index), para a indexação ocorrer sem esses parâmetros, realize o seguinte comando:

dspace-base/bin/dspace index-db-browse -f -d

Tomcat

Reinicie o tomcat e verifique se ocorreu algum problema.

Em casos de erros nesses processos ou nessa Wiki, contate nossa equipe pelo Telefone: (61) 3217-6449/6460.