Av. Paulista, n.

726 17 andar
http://www.quatroelementos.com.br
Fone: + 55 11 4506-3226
cursos@quatroelementos.com.br
rodrigo@quatroelementos.com.br

Curso DSpace
Desenvolvimento e Administrao de Repositrios Digitais
Vania Santos e Rodrigo Prado de Jesus
So Paulo, 2014

Mdulo Instalao do DSpace - Windows

Objetivos do Mdulo

Ao final deste mdulo, voc ser

capaz de:

Instalar a infra-estrutura de software

necessria para o DSpace
Fazer as configuraes bsicas para
instalao do DSpace
Instalar o DSpace em ambiente Microsoft
Windows

Pr-requisitos para instalao

Antes de iniciar a instalao do DSpace

necessrio preparar a infraestrutura de software
para o pleno funcionamento do sistema. Os
aplicativos que devem ser instalados so os
seguintes:
JDK - Java Development Kit
Apache Maven
Apache Ant
Servidor de banco de dados - PostgreSQL ou
Oracle
Servidor de aplicao Tomcat, Jetty, Glassfish,
etc.

JDK - Java Development Kit

O DSpace um aplicativo desenvolvido

com a utilizao da linguagem de
programao Java. Assim, ser necessria
a instalao de uma maquina virtual Java.
O DSpace precisa da verso do JDK 6 ou
mais recente para rodar.
A ltima verso disponvel pode ser obtida
no endereo:

http://www.oracle.com/technetwork/java/javase/downloads/
index.html

Apache Maven

Apache Maven uma ferramenta para

gerenciamento e automao de projetos
em Java.
O Apache Maven necessrio na primeira
fase do processo de compilao do
DSpace para montar o pacote de
instalao do sistema.
A ltima verso do Apache Maven pode
ser obtida no endereo:
http://maven.apache.org/download.html

Apache Ant

Apache Ant uma ferramenta de

linha de comando para construir
aplicaes em Java. Ele fornece
diversas tarefas para compilar,
montar, testar e executar programas
em Java.
A ltima verso do Apache Ant pode
ser obtida no endereo:
http://ant.apache.org/bindownload.cgi

PostgreSQL

O PostgreSQL um servidor de banco

de dados de cdigo aberto que roda
em diversos sistemas operacionais.
Possui suporte completo para chaves
estrangeiras, joins, views, triggers e
procedures.
A ltima verso do PostgreSQL pode
ser obtida no endereo:
http://www.postgresql.org/download/

Apache Tomcat

Apache Tomcat um servidor de

aplicao Java que implementa as
tecnologias Java Servlet e Java Server
Pages. necessrio para hospedar a
aplicao Dspace.
A ltima verso do Apache Tomcat
pode ser obtida no endereo:
http://tomcat.apache.org/

DSpace

A ltima verso do DSpace pode ser

obtida pelo endereo:
http://www.dspace.org/latest-release/

Instalao DSpace

Instalao DSpace - Windows

Antes de iniciar a instalao certifique-se

que voc baixou e salvou todos os prrequisitos mencionados em uma pasta,
como mostrado abaixo:

Instalao do JDK

Para instalar o JDK, d um clique duplo

no arquivo jdk-***-windows-***.exe,
siga as instrues na tela e aceite o
acordo de licena:

Instalao do Apache Ant

Para instalar o Apache Ant, crie uma pasta

chamada ant, por exemplo, no drive C: e
extraia o contedo do arquivo apache-ant-***bin.zip nessa pasta.

Instalao do Apache Maven

Para instalar o Apache Maven, crie uma pasta

chamada maven, por exemplo, no drive C: e
extraia o contedo do arquivo apache-maven***-bin.zip na pasta C:\maven.

Definir variveis de ambiente

Agora necessrio definir algumas variveis de

ambiente para que o sistema encontre os programas
instalados

Adicionar varivel PATH:

C:\Program Files\Java\jdk*.**\bin;C:\ant\bin;C:\maven\bin

Setar na varivel JAVA_HOME o valor:

C:\Program Files\Java\jdk***\

Setar na varivel ANT_HOME o valor:

C:\ant\

Teste se tudo est funcionando

Para testar se tudo est funcionando, execute os

comandos abaixo no prompt de comando:
> java version

> ant version

> mvn version

Instalao do PostgreSQL

Para instalar o PostgreSQL, d um clique

duplo no arquivo postgresql-***windows.exe e siga as instrues do
instalador.

Criao da base de dados para o

DSpace

Crie uma base de dados para o DSpace. Para

fazer isso, execute o seguinte programa:
Iniciar->Todos os programas->PostgreSQL ***>pgAdmin III
Nessa janela, clique com o boto direito no seu
servidor e clique em conectar, como mostrado
abaixo:

Criao da base de dados para o

DSpace

Primeiro necessrio criar um usurio chamado

dspace. Depois de expandir a conexo com o
servidor, clicando em +, clique com o boto
direito do mouse em Login Roles e em New
Login Role conforme figura abaixo:

Criao da base de dados para o

DSpace

Agora crie um usurio chamado dspace com a

senha desejada (neste caso, a senha
dspace), como mostrado na tela seguinte e
clique em OK.

Criao da base de dados para o

DSpace

Crie uma database chamada dspace

colocando como owner o usurio dspace
criado na etapa anterior, conforme mostra a
figura abaixo e clique em OK.

Instalao do Apache Tomcat

Para instalar o Apache Tomcat, d um

clique duplo no arquivo apache-tomcat***.exe e siga as instrues na tela.

Instalao do Apache Tomcat

Ser solicitada a incluso do usurio e senha

para acesso administrao do Tomcat, entre
com esses dados conforme tela abaixo:

Instalao do Apache Tomcat

Ser solicitada a definio da pasta onde o Tomcat

ser instalado. Para essa instalao ns usamos a
pasta C:\Tomcat, conforme figura abaixo:

Siga as instrues padres at que a instalao

seja concluda

Iniciar a instalao do DSpace

Antes de iniciar a instalao do DSpace, crie um

diretrio para armazenar os arquivos do
DSpace. Nesse caso, ns usaremos C:\dspace

Iniciar a instalao do DSpace

Extraia todo o contedo do arquivo dspace-***src-release.zip numa pasta no drive C:. Nesse
caso, ns usaremos a pasta C:\dspace-***-srcrelease, conforme figura abaixo:

Iniciar a instalao do DSpace

build.properties

O arquivo build.properties contm as

configuraes bsicas para instalao do
DSpace pela primeira vez. Esse arquivo
est localizado na pasta [dspace-source].
Faa as configuraes iniciais do DSpace ,
editando o arquivo build.properties.

build.properties - continuao

dspace.install.dir- deve ser definido o

diretrio de instalao do DSpace.
dspace.hostname- nome completo do
domnio do servidor web.
dspace.baseUrl- URL completa da pgina
inicial do DSpace
dspace.name- Nome prprio do seu servidor,
ex. Repositrio Digital da Universidade.
default.language - linguagem padro para os
metadados, ex. pt_BR.

build.properties - continuao

db.name - banco de dados usado na aplicao

DSpace (postgres or oracle).
db.driver - Driver do banco de dados.
db.url URL para conexo ao banco de dados.
db.username- O usurio do banco de dados.
db.password- A senha do banco de dados.
mail.server- Nome completo do domnio do
servidor de e-mail que ser usado pelo DSpace.
mail.from.address- Endereo de e-mail a ser
colocado como remetente nos e-mails enviados
pelo DSpace.

build.properties - continuao

mail.feedback.recipient- E-mail para receber

feedbacks.
mail.admin- E-mail do administrador do DSpace.
mail.alert.recipient- E-mail para receber
alertas/erros do servidor DSpace (no essencial,
mas bem til).
mail.registration.notify E-mail quando novos
usurios se registram (opcional).
Aps a edio do arquivo build.properties
basta fechar e salvar o aquivo.

Construir o pacote de instalao

Depois de ter editado e salvo o arquivo de

configurao, abra o prompt de comando e v
para a pasta C:\dspace-***-srcrelease\dspace

Agora digite o comando mvn package e tecle

enter

A conexo com Internet necessria para

executar essa operao, pois o Maven ir fazer o
download de todas as dependncias necessrias
para o DSpace.

Construir o pacote de instalao

DSpace

Caso voc tenha problemas nesse comando,

verifique a pgina abaixo de como corrigir o erro
[arquivo pom.xml]:
https://github.com/DSpace/DSpace/pull/503/files
Ao final da operao, voc receber a seguinte
mensagem:

Instalar o DSpace e inicializar base de dados

Agora no prompt de comando v para a pasta

C:\dspace-***-srcrelease\dspace\target\dspace-***-build

Execute o comando ant fresh_install.

Instalar o DSpace e inicializar base de dados

Ao final da operao, voc receber a seguinte

mensagem:

Criar usurio para administrao do DSpace

Para criar uma conta para o administrador do

sistema execute o seguinte comando e siga os
passos solicitados:
C:\dspace\bin\dspace create-administrator

Fazer deploy da aplicao

Usando o Windows Explorer v at a pasta

C:\dspace\webapps

Fazer deploy da aplicao

Copie as pastas jspui, oai, solr e

xmlui para a pasta webapps do Tomcat. Ex:
C:\Program Files\Apache Software Foundation\Tomcat
7.0\webapps

Testar a aplicao DSpace

Inicie o servio do Tomcat caso ele no esteja

rodando.
Abra as pginas http://localhost:8080/xmlui e
http://localhost:8080/jspui no navegador.

Av. Paulista, n. 726 17 andar

http://www.quatroelementos.com.br
Fone: + 55 11 4506-3226
cursos@quatroelementos.com.br
rodrigo@quatroelementos.com.br

Curso DSpace
Desenvolvimento e Administrao de Repositrios Digitais
Vania Santos e Rodrigo Prado de Jesus
So Paulo, 2014

Fim do

Mdulo Instalao do DSpace - Windows