Upgrade versão 5.x

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.

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

Caso ocorra algum problema aqui, realize o seguinte comando e retorne ao anterior:

psql -U dspace -f dspace-base/etc/postgres/update-sequences.sql

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.