Criação de Repositório Institucional: … 6 - Efetuado os ajustes, você pode salvar as alterações do arquivo e fechá-lo. No caso do vim, isto foi feito pressionando a tecla

- 1 -

Criação de Repositório Institucional:

Manual/Orientações sobre a

Instalação do Dspace 5.3

Objetivo: Auxiliar as instituições educacionais na

criação de suas bibliotecas digitais (Repositórios

Institucionais) cujo objetivo é disseminar gratuitamente

o seu patrimônio científico-acadêmico à sociedade.

Acesso gratuito à ciência universitária é realidade:BuscadorCoruja.com / BuscadorBuho.com / ResearcherOwl.com

http://researcherowl.com/

http://buscadorbuho.com/

http://buscadorcoruja.com/

- 2 -

Acesso gratuito à ciência universitária é realidade:

BuscadorCoruja.com / BuscadorBuho.com / ResearcherOwl.com

O maior portal digital de acesso gratuito e aberto à ProduçãoCientífica dos países Lusófonos e membros do Mercosul.

(4,5 Milhões de: artigos científicos, dissertações, teses, resumos,monografias, anais etc.)

Público-alvo: Professores(as), universitários(as),pesquisadores(as), mestrandos(as), doutorandos(as),

universidades, bibliotecas, estudantes, sociedade et al.

BuscadorCoruja (Facebook)

APP – GRÁTIS (Android - Google Play)





https://play.google.com/store/search?q=buscadorcoruja&c=apps

https://www.facebook.com/pages/BuscadorCoruja/853786484675191




- 3 -

1. Apresentação do Dspace 5.3

O Dspace é um software livre e que possui natureza operacional específica

de preservar objetos digitais. Foi desenvolvido para permitir a criação de repositórios

digitais com funções de gerenciamento, preservação e visibilidade da produção

intelectual, permitindo sua adoção por outras instituições. O Dspace permite o

gerenciamento da produção científica em qualquer tipo de material digital, como por

exemplo, documentos (artigos, relatórios, etc), livros, teses, arquivos de áudio e

vídeo, etc.

O presente manual vem auxiliar a instalação e configuração do Sistema para

Construção de Repositórios Institucionais Digitais, o Dspace, versão 5.3.

2. Requisitos

A instalação apresentada neste manual foi feita na distribuição Linux Debian,

versão 8 (Jessie), em uma máquina virtual com 2GB de memória RAM e 12GB de

espaço de armazenamento. Obviamente, este ambiente foi para efeito de testes,

para ensinamento da instalação do Dspace. Em seu servidor você pode, se assim

desejar, atribuir uma configuração mais robusta.

A instalação também pode ser feita em sistemas baseados em Unix, MAC

OS, Linux ou Windows. Por preferência do autor, essa instalação foi efetuada em

Linux.

3. Como adquirir o Dspace

Você pode adquirir o pacote de instalação do Dspace 5.3 no seguinte link:

<https://github.com/DSpace/DSpace/releases/tag/dspace-5.3>. Na área downloads,

há diversas opções disponíveis a serem baixadas, dentre elas, o manual do Dspace.

No momento o que nos interessa é o seu pacote de instalação. Baixe o arquivo

“dspace-5.3-src-release.tar.gz”. É um pacote de mais ou menos 5.3MB.





- 4 -

Efetuado o download, você pode agora descompactá-lo. Esta ação pode ser

feita abrindo o terminal Linux. Em seguida, acesse no próprio terminal o local em

que se encontra o pacote de instalação e digite o seguinte comando (não precisa

estar como root):

Se tudo ocorreu bem, provavelmente, a pasta descompactada apareceu no

diretório em execução, com o nome de dspace-5.3-src-release. Feito isto, vamos

agora preparar o ambiente para a instalação do pacote, configurando o arquivo de

instalação e instalando algumas ferramentas.

4. Configurando o arquivo “build.properties”

Antes de começarmos a instalação do Dspace 5.3, é necessário que

configuremos o arquivo de instalação do mesmo. Ainda no terminal Linux, acesse o

diretório descompactado anteriormente (dspace-5.3-src-release), e digite o

seguinte comando:

O “vim” é um editor de textos capaz de editar arquivos no próprio terminal.

Esse editor foi usado por preferência do autor, ficando a seu critério editar este

arquivo, e outros que constam nesse manual, com um editor de sua preferência

(nano, vi, etc.).

Este arquivo contém vários parâmetros necessários à instalação do Dspace. A

Tabela 1 apresenta os principais parâmetros a serem configurados:


$ tar –xvf dspace-5.3-src-release.tar.gz

$ vim build.properties




- 5 -

Tabela 1: Parâmetros de configuração do arquivo 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 embargadosou 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;

Fonte: http://wiki.ibict.br/index.php/Instala%C3%A7%C3%A3o_do_DSpace_5.x

Basicamente, para a instalação feita neste manual, os únicos parâmetros

alterados foram: dspace.name, default.language, db.username, db.password,

mail.server, mail.server.username, mail.from.address, mail.feedback.recipient,

mail.admin, mail.alert.recipient, mail.registration.notif, mail.helpdesk. Repare que se

você estiver em uma rede em que seja necessário a autenticação junto a um

servidor proxy é necessário também fazer as alterações dos parâmetros de proxy no

arquivo nesse arquivo.





http://wiki.ibict.br/index.php/Instala%C3%A7%C3%A3o_do_DSpace_5.x

http://localhost:8080/

- 6 -

Efetuado os ajustes, você pode salvar as alterações do arquivo e fechá-lo. No

caso do vim, isto foi feito pressionando a tecla “esc” e digitar o seguinte

comando: :x!

5. Download e instalação das ferramentas necessárias a instalação do Dspace

Para que o Dspace possa ser corretamente instalado, é necessário que seja

feita a instalação de algumas ferramentas, a saber:

Para compilação

Oracle-JDK; ImageMagick; Apache-Maven.

Para Instalação

Apache-Ant

Para execução

Oracle-JDK; Apache-Tomcat; PostgreSQL.

Antes de instalarmos essas ferramentas, é recomendado que se crie um usuário

com o nome “dspace”, para que as permissões de acesso sejam específicas desse

usuário. Para que isto seja feito, juntamente com a criação do grupo “dspace”, no

terminal Linux (logado como root), execute os seguintes comandos:


# addgroup dspace

#useradd -m dspace -g dspace

#passwd dspace




- 7 -

Ao executar esses comandos, ao final, será criado o grupo dspace, o usuário

dspace (sendo já adicionado ao grupo), e uma nova senha para este usuário.

Com o usuário e grupo dspace já criados, agora sim, podemos instalar as

ferramentas descritas anteriormente.

5.1. Instalação do PostgreSQL

Como toda aplicação, o Dspace precisa de uma base de dados para criação e

alteração dos registros. Os SGBDs sugeridos para que trabalhem com o Dspace são

o Oracle e o PostgreSQL. Neste manual escolhemos o PostgreSQL, por ser um

software livre, gratuito e bem robusto.

Para instalar o PostgreSQL, primeiramente, vamos executar o seguinte

comando no terminal (logado como root):

A versão instalada neste manual foi a 9.4. Portanto, em alguns momentos

abaixo, esse número estará em algumas linhas de comando. Veja qual sua versão e

altere para este número.

Efetuada a instalação, vamos agora configurar alguns arquivos do SGBD

(lembrando que é feito tudo como root):

postgresql.conf


# apt-get install postgresql

# vim /etc/postgresql/9.4/main/postgresql.conf




- 8 -

Procure pela linha #listen_addresses = 'localhost'. Remova o caracter “ # “ dessa linha.

pg_hba.conf

Adicione, ao final desse arquivo, o seguinte comando:

Agora é o momento de criar o usuário do banco de dados. Para isto você

deverá executar os comandos abaixo. Para o usuário e senha, digite aquele que

você configurou no arquivo build.properties anteriormente:

Em seguida, pedirá a senha (digite a que foi configurado no arquivo build.properties).

Criado o usuário, podemos então criar a base de dados. Após executado os

comandos acima, você digitar a seguinte linha de comando que criará a base de

dados:


# vim /etc/postgresql/9.4/main/pg_hba.conf

host all all 127.0.0.1 255.255.255.255 md5

# su postgres

# create user –d –A –P usuário_configurado_no_build.properties

# createdb -E UNICODE dspace

# exit




- 9 -

O parâmetro dspace será o nome do banco de dados. Esse nome é o mesmo que

você configurou no arquivo build.properties. É o nome final que se encontra na linha

db.url desse arquivo.

5.2 Instalação do Oracle JDK

O JDK (Java Development Kit) é o kit de desenvolvimento Java. É por meio dele em

que é possível criar softwares para a plataforma Java. Há versões de código aberto

desse kit. Um exemplo clássico em distribuições Linux é o Open JDK. Para a nossa

instalação do dspace não usaremos essa versão, pois o Dspace só funciona com a

versão do site da Oracle. Para esta instalação, utilizaremos a versão 8 desse kit.

Logado como root, digite o seguinte comando:

Se imprimir alguma versão do java, verifique se vocêe já possui o Open JDK

instalado. Para que possamos instalar o JDK da Oracle, vamos remover o Open

JDK. Se você não o tem instalado, pode desconsiderar este comando:

Feito isto, vamos começar nossa instalação do Oracle JDK. Ainda logado

como root, digite os seguintes comandos no terminal:


# java –version

# apt-get remove --purge openjdk-*




- 10 -

Terminada a execução das linhas de comando acima, vamos atualizar o nosso

sources.list:

Em seguida, vamos efetuar a instalação do JDK:

Efetuado o download, será pedido para aceitar os termos de licença. Clique em Ok.

Quando a instalação for concluída, execute o seguinte comando no terminal:

Se tudo ocorreu bem, irá aparecer a versão do java, conforme abaixo:


# echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee

/etc/apt/sources.list.d/webupd8team-java.list

# echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee -a

/etc/apt/sources.list.d/webupd8team-java.list

# apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EEA14886

# apt-get update

# apt-get install oracle-java8-installer

# java –version




- 11 -

Em seguida, digite o seguinte comando:

Irá parecer algo como na linha abaixo, que é a versão do javac:

Pronto! O Java foi instalado!

5.3. Download do Apache-Maven

O Apache-Maven é uma das ferramentas responsáveis pela compilação do

Dspace. Para efetuarmos a instalação do mesmo, devemos primeiramente, fazer o

download de seu pacote. O Apache-Maven pode ser adquirido no seguinte

endereço: <http://maven.apache.org/download.cgi>. Para este manual, foi utilizado a

versão 3.3.3. Na área Files do site, você encontrará o seguinte arquivo para

instalação: “apache-maven-3.3.3-bin.tar.gz”. Faça o download deste pacote. Em

seguida, é necessário descompactá-lo:


java version "1.8.0_66"

Java(TM) SE Runtime Environment (build 1.8.0_66-b17)

Java HotSpot(TM) 64-Bit Server VM (build 25.66-b17, mixed mode)

# javac –version

javac 1.8.0_05

$ tar -vzxf apache-maven-x.x.x-bin.tar.gz




- 12 -

5.4. ImageMagick

Para que o Dpsace possa ser capaz de criar e exibir miniaturas das capas

dos documentos PDF’s, é necessário que se instale a ferramenta ImageMagick.

Para confirmar se você já tem instalado esta ferramenta, execute o seguinte

comando no terminal:

Se você possui o ImageMagick instalado, ao executar o comando acima, a

versão do mesmo aparecerá no terminal. Se este não for o caso, devemos, portanto,

instalá-lo. Logado como root, execute o comando abaixo:

Pronto! Com isto, o ImageMagick está instalado. Para confirmar, digite no terminal

“identify –version”. Se tudo deu certo, a versão do ImageMagick aparecerá na tela.

5.5. Apache-Ant

A ferramenta responsável por efetuar a instalação do Dpace é o Apache-Ant.

Este pacote pode ser adquirido para download no seguinte endereço:

< http://ant.apache.org/bindownload.cgi>. Para este manual, foi baixado o seguinte

arquivo: “apache-ant-1.9.6-bin.tar.gz”. Para descompactar o arquivo, execute o

comando seguinte:


# identify –version

# apt-get install imagemagick




- 13 -

5.6. Apache-TomCat

O Apache-Tomcat é o servidor web responsável por executar o Dspace e deixá-lo

disponível para acesso . Para efetuar o download dessa ferramenta, acesse o

seguinte endereço: <http://tomcat.apache.org/download-80.cgi> . Foi efetuado o

download do arquivo “apache-tomcat-8.0.28.tar.gz”. Para descompactá-lo, execute:

Após descompactá-lo, acesse este pacote pelo terminal. Em seguida, vamos

configurar o arquivo server.xml, adicionando o termo URIEncoding="UTF-8",

conforme o seguinte:

Procure a seguinte linha para alterá-la com o termo citado anteriormente:


$ tar –vzxf apache-ant-1.9.6-bin.tar.gz

$ tar –vzxf apache-tomcat-8.0.28.tar.gz

$ vim conf/server.xml

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="8443" URIEncoding="UTF-8" />




- 14 -

5.7. Compilação e instalação do Dspace

Até agora, estávamos preparando todo o ambiente para instalarmos o

Dspace. Agora iremos, de fato, instalá-lo.

Para continuarmos, é necessário alterarmos algumas permissões e

movermos os pacotes baixados para o diretório /home/dspace, que é a pasta

pessoal do usuário “dspace” que criamos anteriormente. Acesse o diretório em que

estão os pacotes descompactados. Vamos fazer cópias destes pacotes para o

diretório /home/dspace. Logado como root, execute:

Vamos agora alterar o dono e o grupo destes pacotes para o usuário dspace e

grupo dspace (que já foi criado anteriormente). Ainda logado como root, acesse o

diretório /home/dspace. Lá estarão os pacotes que acabamos de copiá-los. O

comando abaixo alterará o proprietário dos arquivos para o usuário dspace:

Em seguida, vamos alterar o grupo destes pacotes. Estes arquivos,

atualmente, pertencem ao grupo root. Provavelmente, o seu pacote também deva

está assim. Para confirmar, execute no terminal o comando “ls –l” e veja qual o

grupo que pertence estes pacotes. O segundo usuário é o grupo atual que o diretório

pertence. Vamos agora alterar de root para dspace:


# cp –r apache-maven-3.3.3 apache-ant-1.9.6 apache-tomcat-8.0.28 dspace-5.3-src-release

/home/dspace

# chown dspace apache-maven-3.3.3 apache-ant-1.9.6 apache-tomcat-8.0.28 dspace-5.3-src-

release




- 15 -

A partir de agora, todo o procedimento que formos realizar, deverá ser

efetuado com o usuário dspace, salvo se especificado outro usuário. Para logar no

usuário dspace, no terminal, digite o seguinte comando.

Em seguida, será requerida a senha desse usuário. Digite a senha que você

cadastrou anteriormente.

Para compilar o dspace, acesse o pacote do mesmo, em que foi feito o

download, pois a compilação é feita dentro da pasta do dspace que foi baixada. Para

efetuar a compilação, digite o seguinte comando:

Se tudo deu certo, ele começará a fazer downloads de alguns pacotes, como mostra

a Figura 1:


# chown –c –R dspace:dspace apache-maven-3.3.3 apache-ant-1.9.6 apache-tomcat-8.0.28

dspace-5.3-src-release

$ su dspace

$ /home/dspace/apache-maven-3.3.3/bin/mvn -U clean package




- 16 -

Figura 1: Início da compilação do Dpsace pelo Apache-Maven

Fonte: o autor

Esse procedimento leva em torno de 25 minutos para ser concluído. Se tudo ocorrer

bem, uma mensagem de sucesso aparecerá na tela: BUILD SUCCESSFUL. Essa

mensagem se apresenta conforme mostra a Figura 2:

Figura 2: Sucesso na compilação do Dspace pelo Apache-Maven

Fonte: o autor





- 17 -

Concluída a compilação, assumindo que você já esteja dentro do pacote do

dspace, acesse agora o seguinte diretório:

É dentro deste diretório que efetuaremos a instalação do Dspace pelo Apache-Ant.

Execute o seguinte comando:

Após executado o comando acima, deverá aparecer uma tela semelhante a Figura

3:

Figura 3: Início da instalação do Dspace pelo Apache-Ant

Fonte: o autor


$ cd dspace/target/dspace-installer

$ /home/dspace/apache-ant-1.9.6/bin/ant fresh_install




- 18 -

A instalação levará em torno de 2 minutos até ser concluída, apresentando a

mensagem de BUILD SUCCESSFUL, conforme a Figura 4:

Figura 4: Sucesso na instalação do Dspace pelo Apache-Ant

Fonte: o autor

Uma falha bastante comum é a falha de não ter a permissão para criar o

diretório dspace, no diretório /, conforme mostra a Figura 5:





- 19 -

Figura 5: Falha na criação da pasta “dspace” no diretório /

Fonte: o autor

Para resolver este problema, vamos criar este diretório manualmente.

Primeiramente, vamos logar como root. Em seguida, acesse o diretório / do sistema

operacional Linux. É só executar o seguinte comando:

Vamos agora criar a pasta dspace. Para que isso seja possível, execute o seguinte

comando:

Feito isto, vamos alterar o proprietário do diretório e o grupo deste diretório para

dspace. Primeiro, vamos alterar o proprietário:


# cd /

# mkdir dspace




- 20 -

Agora, iremos alterar o grupo ao qual este diretório irá pertencer:

Terminado isto, podemos agora sair do usuário root e logar como usuário dspace.

Em seguida, vamos acessar novamente o diretório “installer” do dspace:

E execute o seguinte comando, para que o Apache-Ant instale o Dspace:

Se tudo ocorreu bem, será apresentado algumas mensagens conforme a Figura 3 e

a Figura 4.

Finalmente, falta-nos ativar o Tomcat com a aplicação do Dspace. Para isto, vamos

primeiramente copiar três pacotes do Dspace que veio juntamente com a instalação

feita no diretório /dspace: o jspui, solr e oai. Isto pode ser feito copiando estas pastas

para dentro da pasta de aplicativos do Tomcat, por meio dos seguintes comandos:


# chown dspace dspace

# chown –c –R dspace:dspace dspace

$ cd /home/dspace/dspace-5.3-src-release/dspace/target/dspace-installer

$ /home/dspace/apache-ant-1.9.6/bin/ant fresh_install




- 21 -

Opcionalmente, você pode expandir os parâmetros de memória reservado ao

Tomcat. Para que isto seja possível, você deve editar o arquivo “profile” do Linux e

acrescentar, no final do arquivo, a seguinte linha (logado como root):

Pronto! Basicamente, o Dspace está pronto para ser executado.

5.8. Executando o Dspace

Para que o Dpace possa ser executado deve-se, primeiramente, iniciar o

servidor Tomcat. Você pode fazer isto da seguinte forma (não precisa ser root):

Se o comando acima foi executado corretamente, será mostrado uma mensagem,

conforme mostra a Figura 6:


$ cp –R /dspace/webapps/jspui /home/dspace/apache-tomcat-8.0.28/webapps

$ cp –R /dspace/webapps/solr /home/dspace/apache-tomcat-8.0.28/webapps

$ cp –R /dspace/webapps/oai /home/dspace/apache-tomcat-8.0.28/webapps

# vim /etc/profile

JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"

export JAVA_OPTS

$ /home/dspace/apache-tomcat-x.x.x/bin/startup.sh




- 22 -

Figura 6: Inicialização do Tomcat

Fonte: o autor

Feito isto, você já pode acessar o Dspace. Abra um navegador web (Firefox,

Google Chrome, etc). Na barra de endereços, digite a seguinte url:

http://localhost:8080/jspui. Se tudo ocorreu bem, você já deverá ser capaz de

visualizar a página do Dspace 5.3, conforme mostra a Figura 7:





- 23 -

Figura 7: Página inicial do Dspace 5.3 – JSPUI

Fonte: o autor

Você pode também acessar o painel “solr” por meio do endereço

http://localhost:8080/solr, conforme mostra a Figura 8, e “oai” por meio do endereço

http://localhost:8080/oai, conforme mostra a Figura 9:

Figura 8: Página inicial do Dspace 5.3 – SOLR

Fonte: o autor





- 24 -

Figura 9: Página inicial do Dspace 5.3 – OAI

Fonte: o autor

6. Algumas configurações pós-instalação

Após a instalação do Dspace 5.3, ainda é necessário que se crie um conta de

Administrador para o mesmo. Com o usuário dspace execute o seguinte comando:

Com a execução do comando acima, será pedido um nome, sobrenome, email e

uma senha. É com estes últimos dados que você poderá acessar a área de

administrador do Dspace.

6.1. Agendamento de tarefas no Crontab


$ /dspace/bin/dspace create-administrator




- 25 -

É recomendável que se agende algumas tarefas que serão executadas

durante uso do sistema para que não seja tão sobrecarregado. Isto pode ser feito

pela tabela crontab.

Logado como root, execute o comando “crontab –e”. Quando o arquivo for

aberto, adicione ao final dele as seguintes linhas:

ATENÇÃO: Criação de Repositório Institucional: Manual/Orientações

sobre a Instalação do Dspace 5.3

Esperamos que este Manual tenha lhe ajudado. Pedimos gentilmente, em contrapartida,

que nos avise de seu uso por e-mail: [email protected]

Ressaltamos a importância da disseminação do conhecimento à sociedade (Acesso Aberto).

Agradecemos e desejamos boa sorte!

25/11/2015

Fontes Consultadas:

<http://wiki.ibict.br/index.php/Instala%C3%A7%C3%A3o_do_DSpace_5.x>. Acesso

em: 20 de outubro de 2015.

<http://www.ibict.br/pesquisa-desenvolvimento-tecnologico-e-inovacao/Sistema-para-

Construcao-de-Repositorios-Institucionais-Digitais>. Acesso em: 20 de outubro de

2015.

< http://www.vivaolinux.com.br/dica/Java-Oracle-JDK-8-no-Debian-Wheezy>. Acesso

em: 20 de outubro de 2015.


0 0 * * * /dspace/bin/dspace oai import

0 1 * * * /dspace/bin/dspace filter-media

0 2 * * * /dspace/bin/dspace index-discovery




mailto:[email protected]

Documents

Criação de Repositório Institucional: … 6 - Efetuado os ajustes, você pode salvar as alterações do arquivo e fechá-lo. No caso do vim, isto foi feito pressionando a tecla