Mudanças entre as edições de "Upgrade versão 5.x"
(→Atualizar requisitos para utilizar DSpace 5.x (caso necessário)) |
(→Atualizar e/ou Baixar requisitos para utilizar DSpace 5.x (caso necessário)) |
||
| Linha 13: | Linha 13: | ||
== Atualizar e/ou Baixar requisitos para utilizar DSpace 5.x (caso necessário) == | == Atualizar e/ou Baixar requisitos para utilizar DSpace 5.x (caso necessário) == | ||
| − | *Java 7 (Oracle | + | *Java 7 (Oracle ou preferencialmente OpenJDK) |
*Apache Maven 3.0.5 ou versão mais atual | *Apache Maven 3.0.5 ou versão mais atual | ||
*Apache Ant 1.8 ou versão mais atual | *Apache Ant 1.8 ou versão mais atual | ||
Edição das 09h51min de 22 de dezembro de 2015
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):
- Caso não apareça a mensagem BUILD SUCCESSFUL, um erro que pode ocorrer nesse momento, é erro de alocação de memória:
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.
