DSpace no Ubuntu 12.04 – Instalação via Banco de Dados Oracle 11g

Introdução

DSpace é um repositório digital construído para indexação, preservação e compartilhamento de produções intelectuais em formato digital, tais como: imagens, artigos, teses, dissertações, vídeos e etc, permitindo a disponibilização destes conteúdos na Internet.

O sistema DSpace é utilizado, principalmente, como repositório institucional e desempenha alguns papéis importantes:

  • Facilita o depósito e a gestão dos documentos;
  • Agiliza o acesso aos documentos através de listas e pesquisas;
  • Aumenta a preservação dos documentos ao longo do tempo;
  • Possibilita a publicação rápida de produções científicas;
  • Aumenta a visibilidade da produção cientifica;
  • Centralização das produções científicas em um único local;
  • Facilita a quantificação de quantos downloads foram efetuados para cada uma das produções e quantas vezes foram visualizadas;
  • Possibilita definir um identificador único para cada documento.

Referências: projeto.rcaap.pt – sistema_dspace.html

A instalação foi construída no seguinte cenário:

  • Distribuição/Versão de S.O: Ubuntu 12.04.4 LTS
  • Aplicação/Versão: dspace-4.1-release
  • Banco/Versão: Banco de dados Oracle 11g release (11.2)
Instalação de dependências

1. Atualize a lista de pacotes dos repositórios do Ubuntu Linux:

$ sudo apt-get upadete

2. Instale o JDK:

$ sudo apt-get install openjdk-7-jdk

3. Instale o Tomcat 6:

$ sudo apt-get install tomcat6 tomcat6-admin tomcat6-common tomcat6-user tomcat6-docs tomcat6-examples

4. Instale o Apache Ant e o Maven:

$ sudo apt-get install ant maven2

5. Edite o arquivo do Tomcat /etc/tomcat6/server.xml, alterando a forma de conexão com a aplicação e criando os contextos necessários para o DSpace:

# vim /etc/tomcat6/server.xml

<Connector port=”8080″ protocol=”HTTP/1.1″
maxThreads=”150″
minSpareThreads=”25″
maxSpareThreads=”75″
enableLookups=”false”
redirectPort=”8443″
acceptCount=”100″
connectionTimeout=”20000″
disableUploadTimeout=”true”
URIEncoding=”UTF-8″/><Host name=”localhost” appBase=”webapps”
unpackWARs=”true” autoDeploy=”true”
xmlValidation=”false” xmlNamespaceAware=”false”>

<Context path=”/xmlui” docBase=”/dspace/webapps/xmlui” allowLinking=”true”/>
<Context path=”/jspui” docBase=”/dspace/webapps/jspui” allowLinking=”true”/>
<Context path=”/solr” docBase=”/dspace/webapps/solr” allowLinking=”true”/>

6. Faça a download do DSpace via browser, ou através do Wget:

Obs.: lembrando que este tutorial foi baseado na release 4.1.

Ou:

# wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/4.1/dspace-4.1-src-release.zip

7. Descompacte o arquivo:

# unzip dspace-4.1-src-release.zip

8. Crie o usuário do DSpace:

# useradd -m dspace

9. Crie na raiz / o diretório dspace, neste local será instalada a aplicação:

# mkdir dspace

10. Baixe o cliente Oracle no site:

Baixe os pacotes:

  • oracle-instantclient11.2-basic-11.2.0.4.0-1.x86_64.rpm
  • oracle-instantclient11.2-odbc-11.2.0.4.0-1.x86_64.rpm
  • oracle-instantclient11.2-devel-11.2.0.4.0-1.x86_64.rpm
  • oracle-instantclient11.2-precomp-11.2.0.4.0-1.x86_64.rpm
  • oracle-instantclient11.2-sqlplus-11.2.0.4.0-1.x86_64.rpm
  • oracle-instantclient11.2-tools-11.2.0.4.0-1.x86_64.rpm

11. No site da Oracle, só existe disponível pacotes no formato .rpm, então, será necessário convertê-los em .deb e, na sequência, instalá-los.

Exemplo:

# alien oracle-instantclient11.2-basic-11.2.0.4.0-1.x86_64.rpm
# dpkg -i oracle-instantclient11.2-basic_11.2.0.4.0-2_amd64.deb

Faça este procedimento para todos os pacotes.

tnsnames / ojdbc6.jar / build.properties

Criação do arquivo “tnsnames”

12. Crie o arquivo de tnsnames do Oracle e inclua as informações do seu banco:

# touch /usr/lib/oracle/11.2/client64/lib/network/admin/tnsnames.ora

DSNV =
(DESCRIPTION =
(LOAD_BALANCE = YES)
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST =)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = ***** )
(FAILOVER_MODE =
(TYPE = SELECT)
(METHOD = BASIC)
(RETRIES = 20)
(DELAY = 3)
)
)
)

13. Acesse o arquivo do dspace-4.1-src-release:

# cd dspace-4.1-src-release

Para instalar o DSpace com um banco Oracle é um pouco diferente, você vai precisar fazer o download do driver JDBC Oracle, mas, em vez de copiá-lo em um diretório lib, você precisará instalá-lo em seu repositório local Maven.

Instalação do ojdbc6.jar

Acesse o site abaixo e faça o download do arquivo ojdbc6.jar:

14. Instale o ojdbc6.jar com o seguinte comando:

# mvn install:install-file -Dfile=ojdbc6.jar -DgroupId=com.oracle -DartifactId=ojdbc6 -Dversion=11.2.0.3.0 -Dpackaging=jar -DgeneratePom=true

Obs.: todo o comando na mesma linha.

15. Você precisa recompilar o DSpace com um driver Oracle ojdbc6.jar correspondente à sua versão do Oracle. Atualize a versão, conforme abaixo:

# vim dspace-4.1-src-release/pom.xml

<dependency>
<groupId>com.oracle</groupId>
<artifactId>ojdbc6</artifactId>
<version>11.2.0.3.0</version>
</dependency>

Edição do build.properties

16. Acesse o dspace-4.1-src-release e edite o arquivo build.properties. Este arquivo de propriedades, contém as configurações básicas necessárias para a realização da construção/instalação do DSpace pela primeira vez.

# cd dspace-4.1-src-release
# vim build.properties

dspace.install.dir=/dspace
dspace.hostname = <seu domínio>
space.baseUrl = http://<seu domínio>:8080
dspace.name = DSpace < nome da sua instituição >
solr.server=http://<seu domínio>:8080/solr
default.language = pt_BR
db.name=oracle
db.driver= oracle.jdbc.OracleDriver
db.url=jdbc:oracle:thin:@//<nome do seu banco>:1521/<SID do banco de dados definido no tnsnames.ora>
db.username=<usuário do Banco>
db.password=<senha do bando>
db.schema = <esquema do Banco>
db.maxconnections = 30
mail.server = smtp.<seu servidor smtp>.com.br
mail.server.username = <e-mail valido para aplicação usar >
mail.server.password = <senha do e-mail>
alert.recipient =
registration.notify =
Construção do banco e instalação do DSpace

17. Com o comando abaixo, vamos construir e gerar o pacote de instalação do DSpace:

# cd /dspace-4.1-src-release/dspace/
# mvn package

18. Por padrão, o DSpace foi criado para inicializar a instalação em um banco PostgreSQL. Como vamos usar um banco Oracle, mais especificamente o 11.2g, será necessário recompilar a instalação.

Faça o seguinte comando:

# mvn – Ddb.name = pacote Oracle

19. O próximo comando irá instalar e inicializar a base de dados do DSpace:

Obs.: o usuário do banco necessita de GRANT completo, pois trata-se de um pacote (fechado) que cria novas tabelas.

# cd dspace-4.1-src-release/dspace/target/dspace-4.1-build
# ant fresh_install

20. Vamos criar uma conta de administrador no DSpace:

# /dspace/bin/dspace create-administrator

21. Defina as permissões para o Apache Tomcat. Depois, reinicie o serviço de aplicação:

# chown tomcat6:tomcat6 /dspace -R
# service tomcat6 restart

22. Abra a aplicação, pronta para ser utilizada:

  • http://localhost:8080/jspui/
  • http://locolhost:8080/xmlui/

 

Rolar para cima