Mudanças entre as edições de "Instalação do DSpace 4.x"

De IBICT
Ir para: navegação, pesquisa
(Pré-Instalação)
 
(41 edições intermediárias de um usuário não apresentadas)
Linha 1: Linha 1:
 +
== Criando infraestrutura para instalação do DSpace ==
  
== Cirando infraestrutura para instalação do DSpace ==
+
O ''DSpace'' necessita de uma infraestrutura básica para seu pleno funcionamento, a saber:
  
O DSpace necessita de uma infraestrutura básica para seu pleno funcionamento, a saber:
+
- Apache-Ant (em sua '''versão binária''', que pode ser baixada no [http://ant.apache.org/ site do projeto])
  
- Apache-Ant (em sua '''versão binária''', que pode ser baixada no site do projeto: http://ant.apache.org/)
+
- Apache-Maven (em sua '''versão binária''', que pode ser baixada no [http://maven.apache.org/ site do projeto])
  
- Apache-Maven (em sua '''versão binária''', que pode ser baixada no site do projeto: http://maven.apache.org/)
+
- Apache-Tomcat (em sua '''versão binária''', que pode ser baixada no [http://tomcat.apache.org/ site do projeto])
  
- Apache-Tomcat (em sua '''versão binária''', que pode ser baixada no site do projeto: http://tomcat.apache.org/)
+
-Código fonte do [http://www.dspace.org/latest-release '''DSpace''']
  
-Código fonte do ''DSpace'' (http://www.dspace.org/latest-release)
+
-Biblioteca [http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-i586.tar.gz '''JAI_IMAGEIO''']
  
-Bilblioteca '''JAI_IMAGEIO''' (http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-i586.tar.gz)
+
-Biblioteca [http://www.java2s.com/Code/JarDownload/jai/jai_core-1.1.2_01.jar.zip '''JAI_CORE''']
  
-Biblioteca '''JAI_CORE''' (http://www.java2s.com/Code/JarDownload/jai/jai_core-1.1.2_01.jar.zip)
+
-[https://mirror.hmc.edu/ctan/support/xpdf/xpdfbin-linux-3.04.tar.gz '''XPDF''']
 
+
-'''XPDF''' (https://mirror.hmc.edu/ctan/support/xpdf/xpdfbin-linux-3.04.tar.gz)
+
  
 
-'''PostgreSQL'''
 
-'''PostgreSQL'''
Linha 25: Linha 24:
 
<pre>apt-get install postgresql</pre>
 
<pre>apt-get install postgresql</pre>
  
Anote a senha fornecida para o usuário '''dspace'''.
+
Anote a senha fornecida para o usuário ''dspace''.
  
 
=== Instalando Java JDK 1.7.x ===
 
=== Instalando Java JDK 1.7.x ===
  
*Primeiramente baixe o pacote JDK 7 no link (http://www.oracle.com/technetwork/pt/java/javase/downloads/index.html). Se atente às configurações de seu sistema operacional (32 ou 64 bits).
+
*Primeiramente baixe o pacote JDK 7 no [http://www.oracle.com/technetwork/pt/java/javase/downloads/index.html LINK]. '''Se atente às configurações de seu sistema operacional (32 ou 64 bits)'''.
  
 
-Consiga privilégios a partir do código:
 
-Consiga privilégios a partir do código:
 
 
<pre>sudo su</pre>
 
<pre>sudo su</pre>
 
 
-Crie diretório para a instalação de seu pacote JAVA seguindo o código abaixo. O diretório '''/opt''' é reservado para todos os softwares e acréscimos de pastas que não fazem parte da instalação padrão.
 
-Crie diretório para a instalação de seu pacote JAVA seguindo o código abaixo. O diretório '''/opt''' é reservado para todos os softwares e acréscimos de pastas que não fazem parte da instalação padrão.
 
<pre>mkdir /opt/jdk</pre>
 
<pre>mkdir /opt/jdk</pre>
 
 
-Extraia o pacote JAVA:
 
-Extraia o pacote JAVA:
 +
<pre>tar -zxf jdk-7u71-linux-x64.tar.gz -C /opt/jdk</pre>
 +
-Por último, verifique se a extração foi efetuada com sucesso:
 +
<pre>ls /opt/jdk</pre>
  
<pre>tar -zxf jdk-8u5-linux-x64.tar.gz -C /opt/jdk</pre>
+
*Instalando o Java
  
-Por último, verifique se a extração foi efetuada com sucesso:
+
-Levando em consideração os passos acima, os executáveis necessários para a instalação do Java devem estar localizados no diretório: '''/opt/jdk/jdk1.8.0_05/bin/java'''. Para instalar na forma padrão, efetue:
  
<pre>ls /opt/jdk</pre>
+
<pre>update-alternatives --install /usr/bin/java java /opt/jdk/jdk1.x.x_xx/bin/java 100
 +
update-alternatives --install /usr/bin/javac javac /opt/jdk/jdk1.x.x_xx/bin/javac 100</pre>
 +
 
 +
*Verifique se a instalação foi efetuada com sucesso, ao efetuar cada '''update''', a resposta abaixo de cada um deve estar de acordo com o que foi também informado:
 +
 
 +
<pre>
 +
update-alternatives --display java
 +
 
 +
"java - auto mode
 +
link currently points to /opt/jdk/jdk1.x.x_xx/bin/java
 +
/opt/jdk/jdk1.x.x_xx/bin/java - priority 100
 +
Current 'best' version is '/opt/jdk/jdk1.x.x_xx/bin/java'."
 +
 
 +
update-alternatives --display javac
 +
 
 +
"javac - auto mode
 +
link currently points to /opt/jdk/.x.x_xx/bin/javac
 +
/opt/jdk/.x.x_xx/bin/javac - priority 100
 +
Current 'best' version is '/opt/jdk/jdk1.x.x_xx/bin/javac'."</pre>
 +
 
 +
*Outra forma de verificar se a instalação foi efetuada com sucesso, é:
 +
 
 +
<pre>
 +
java -version
 +
 
 +
"java version ".x.x_xx"
 +
Java(TM) SE Runtime Environment (build .x.x_xx-b13)
 +
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)"
 +
</pre>
 +
 
 +
[[Outras opções de instalação da Java JDK]]
  
 
== Configurações iniciais ==
 
== Configurações iniciais ==
Linha 50: Linha 79:
 
*Criando usuário DSpace
 
*Criando usuário DSpace
  
O primeiro passo é a criação do usuário e grupo '''dspace''' para o Sistema Operacional. Isso é possível estando logado como '''root''', e executando os seguintes comandos:
+
O primeiro passo é a criação do usuário e grupo ''dspace'' para o Sistema Operacional. Isso é possível estando logado como '''root''', e executando os seguintes comandos:
  
 
<pre>addgroup dspace
 
<pre>addgroup dspace
Linha 56: Linha 85:
 
passwd dspace</pre>
 
passwd dspace</pre>
  
*Logando ao DSpace
+
Caso o sistema linux seja o '''CentOS''', os comandos executados devem ser:
 +
 
 +
<pre>groupadd dspace
 +
adduser –m dspace -g dspace
 +
passwd dspace</pre>
 +
 
 +
*Logando ao ''DSpace''
  
 
Insira o comando
 
Insira o comando
Linha 77: Linha 112:
 
-jai_core
 
-jai_core
 
<pre>unzip jai_core-1.1.2_01.jar.zip</pre>
 
<pre>unzip jai_core-1.1.2_01.jar.zip</pre>
 +
*Caso acuse o erro: "unzip: comando não encontrado", baixe o programa que permita extração do arquivo: <pre>apt-get install unzip</pre>
 
-XPDF
 
-XPDF
 
<pre>tar -vzxf xpdfbin-linux-3.04.tar.gz</pre>
 
<pre>tar -vzxf xpdfbin-linux-3.04.tar.gz</pre>
  
*Caso a rede esteja sobproxy, faz-se necessário:
+
*Caso a rede esteja ''sobproxy'', faz-se necessário:
 
Criação de diretório '''.m2''' dentro da pasta '''/home/dspace''', e criação de arquivo ''xml'' sob nome de '''settings.xml''', que por sua vez deve conter as seguintes linhas de código:
 
Criação de diretório '''.m2''' dentro da pasta '''/home/dspace''', e criação de arquivo ''xml'' sob nome de '''settings.xml''', que por sua vez deve conter as seguintes linhas de código:
 
<pre>
 
<pre>
Linha 117: Linha 153:
  
 
<pre>su postgres
 
<pre>su postgres
createuser –d –A –P dspace</pre>
+
createuser –d –A –P dspace
 +
exit</pre>
  
 
*Estando logado como ''dspace'', crie a base dados:
 
*Estando logado como ''dspace'', crie a base dados:
Linha 124: Linha 161:
  
 
== Pré-Instalação ==
 
== Pré-Instalação ==
 +
 +
*Definindo parâmetros para o arquivo dspace-x.x-src-release/build.properties:
 +
 +
 +
{| border=1
 +
 +
! width=30% | Tag !! width=40% | Comentário
 +
|-
 +
|'''dspace.install.dir=/home/dspace/dspace-base''' || coloque no lugar de /dspace o caminho da pasta escolhida para instalação do sistema.
 +
|-
 +
| '''dspace.baseUrl = http://localhost:8080''' ||este é o endereço de sua página. Substituahttp://localhost:8080 pela URL do seu site. Caso seu servidor Apache-Tomcat esteja configurado para responder em um porta diferente da porta 80 (que é a padrão do protocolo http) é necessário informar também o número da porta para a conexão. Por exemplo: http://www.meusite.com.br:8080..
 +
|-
 +
| '''dspace.name = DSpace at My University''' || este é nome do repositório, que aparecerá na página principal da interface de usuário..
 +
|-
 +
| '''solr.server=http://localhost:8080/solr''' || este parâmetro indica qual é endereço da aplicação'''solr'''. Esta opera em importantes tarefas, como o sistema de estatísticas e a busca facetada.
 +
|-
 +
| '''default.language = pt_BR''' || o idioma padrão do repositório:
 +
*pt_BR para português brasileiro,
 +
*pt para português de Portugal,
 +
*en para inglês,
 +
*es para espanhol, ...
 +
|-
 +
| '''db.name=postgres''' || O sistema de banco de dados que será utilizado. As principais opções são '''postgres''' e '''oracle'''.
 +
|-
 +
| '''db.driver=org.postgresql.Driver''' || Esta é declaração do driver de conexão com o banco.
 +
|-
 +
| '''db.url=jdbc:postgresql://localhost:5432/dspace''' || Endereço de conexão com o banco. É necessário alterar o nome '''dspace''' para o nome utilizado para base de dados.
 +
|-
 +
|-
 +
| '''db.username=dspace''' || Usuário de conexão com o banco, em geral este será '''dspace'''.
 +
|-
 +
|-
 +
| '''db.password=dspace''' || Senha escolhida para o usuário do banco.
 +
|-
 +
|-
 +
| '''mail.server = smtp.example.com''' || Endereço do servidor '''smtp''' de email.
 +
|-
 +
|-
 +
| '''mail.server.username=''' || Usuário para conexão com o servidor de email.
 +
|-
 +
|-
 +
| '''mail.server.password=''' || Senha para conexão com o servidor de email.
 +
|-
 +
|-
 +
| '''mail.server.port = 25''' || Porta de conexão com o servidor de email.
 +
|-
 +
|-
 +
| '''mail.from.address = dspace-noreply@myu.edu''' || Endereço que aparecerá no campo ' enviado por ' nos emails emitidos pelo repositório.
 +
|-
 +
|-
 +
| '''mail.feedback.recipient = dspace-help@myu.edu''' || Endereço que receberá os '''feedbacks''' de usuário.
 +
|-
 +
|-
 +
| '''mail.admin = dspace-help@myu.edu''' || Endereço do administrador do repositório.
 +
|-
 +
|-
 +
| '''mail.alert.recipient=''' || Email que receberá os alertas sobre problemas no banco.
 +
|-
 +
|-
 +
| '''mail.registration.notify=''' || Email que receberá notificações sobre registros de novos usuários no repositório.
 +
|-
 +
|-
 +
| '''#handle.canonical.prefix = ${dspace.url}/handle/''' || Endereço do servidor de handle. Quanto se utiliza o próprio repositório para gerar as URLs que remeterão aos arquivos do repositório, deve-se retirar o comentário ' # ' desta linha.
 +
''Atenção: Substitua também a palavra dspace.url por dspace.baseUrl''
 +
|-
 +
|-
 +
| '''handle.canonical.prefix = http://hdl.handle.net/''' || Se estiver utilizando o serviço de um servidor handle externo, deve-se substituir http://hdl.handle.net/ pelo endereço deste servidor. Caso tenha optado por utilizar o servidor handle nativo do ''DSpace'', deve-se comentar esta linha, colocando um # no início dela.
 +
|-
 +
|-
 +
| '''handle.prefix = 123456789''' || Este é o prefixo que aparecerá em todos os endereços dos arquivos do repositórop. Substitua o número '''123456789''' por um número conveniente.
 +
|-
 +
|}
 +
 +
*Moficando o '''dspace-4.x-src-release/dspace/config/dspace.cfg''' para geração de '''thumbnails'''. Procurar pela '''tag filter.plugins =''' e modificá-la conforme descrito abaixo:
 +
 +
<pre>
 +
xpdf.path.pdftotext =[camimho-para-a-pata-bin-do-xpdf]/pdftotext
 +
xpdf.path.pdftoppm =[camimho-para-a-pata-bin-do-xpdf]/pdftoppm
 +
xpdf.path.pdfinfo =[camimho-para-a-pata-bin-do-xpdf]/pdfinfo
 +
 +
filter.plugins = \
 +
***PDF Text Extractor, \
 +
***PDF Thumbnail, \
 +
HTML Text Extractor, \
 +
Word Text Extractor, \
 +
JPEG Thumbnail</pre>
 +
 +
''Faz-se necessário a substituição da linhas destacadas por '''***'''''
 +
 +
<pre>#Assign 'human-understandable' names to each filter
 +
plugin.named.org.dspace.app.mediafilter.FormatFilter = \
 +
***  org.dspace.app.mediafilter.XPDF2Text = PDF Text Extractor, \
 +
***  org.dspace.app.mediafilter.XPDF2Thumbnail = PDF Thumbnail, \
 +
  org.dspace.app.mediafilter.HTMLFilter = HTML Text Extractor, \
 +
  org.dspace.app.mediafilter.WordFilter = Word Text Extractor, \
 +
  org.dspace.app.mediafilter.PowerPointFilter = PowerPoint Text Extractor, \
 +
  org.dspace.app.mediafilter.JPEGFilter = JPEG Thumbnail, \
 +
  org.dspace.app.mediafilter.BrandedPreviewJPEGFilter = Branded Preview JPEG
 +
 +
#Configure each filter's input format(s)
 +
***  filter.org.dspace.app.mediafilter.XPDF2Thumbnail.inputFormats = Adobe PDF
 +
***  filter.org.dspace.app.mediafilter.XPDF2Text.inputFormats = Adobe PDF
 +
filter.org.dspace.app.mediafilter.PDFFilter.inputFormats = Adobe PDF
 +
filter.org.dspace.app.mediafilter.HTMLFilter.inputFormats = HTML, Text
 +
filter.org.dspace.app.mediafilter.WordFilter.inputFormats = Microsoft Word
 +
filter.org.dspace.app.mediafilter.PowerPointFilter.inputFormats = Microsoft Powerpoint, Microsoft Powerpoint XML
 +
filter.org.dspace.app.mediafilter.JPEGFilter.inputFormats = BMP, GIF, JPEG, image/png
 +
filter.org.dspace.app.mediafilter.BrandedPreviewJPEGFilter.inputFormats = BMP, GIF, JPEG, image/png</pre>
  
 
== Gerando o pacote binário e ativando o DSpace ==
 
== Gerando o pacote binário e ativando o DSpace ==
 +
 +
*Compilar as bibliotecas '''jai_imageio''' e '''jai_core'''. Estando dentro da pasta '''/home/dspace''', executar os comandos:
 +
 +
<pre>
 +
apache-maven-x.x.x/bin/mvn install:install-file \
 +
-Dfile=jai_core-1.1.2_01.jar \
 +
-DgroupId=javax.media \
 +
-DartifactId=jai_core -Dversion=1.1.2_01 \
 +
-Dpackaging=jar \
 +
-DgeneratePom=true
 +
 +
apache-maven-x.x.x/bin/mvn install:install-file \
 +
-Dfile=jai_imageio-1_1/lib/jai_imageio.jar \
 +
-DgroupId=com.sun.media \
 +
-DartifactId=jai_imageio \
 +
-Dversion=1.0_01 \
 +
-Dpackaging=jar \
 +
-DgeneratePom=true
 +
</pre>
 +
 +
*Compilar o código do ''DSpace''. Estando dentro da pasta '''/dspace-x.x-src-release''', executar os comandos:
 +
 +
<pre>apache-maven-x.x.x/bin/mvn -Pxpdf-mediafilter-support -U clean package</pre>
 +
 +
**Caso não apareça a mensagem '''BUILD SUCCESSFUL''', um erro que pode ocorrer nesse momento, é erro de alocação de memória: <code>java.lang.OutOfMemoryError: Java heap space</code>. 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
 +
*Executar a instalação via software '''Ant''':
 +
 +
<pre>apache-ant-x.x.x/bin/ant fresh_install</pre>
 +
 +
*Uma falha bastante comum, nesse processo, é o erro de permissão de escrita na pasta definida no '''dspace.install.dir=/dspace-base''' do arquivo '''build.properties'''. Portanto para se certificar que o diretório destino de instalação está com permissões de escrita ao usuário dspace, deve-se logar como root e executar o comandos:
 +
 +
mkdir /dspace-base
 +
chown dspace:dspace /dspace-base
 +
*Copiar as aplicações para dentro do '''Tomcat''':
 +
 +
<pre>cp -R /home/dspace/dspace-base/webapps/jspui/ /home/dspace/apache-tomcat-version/webapps/
 +
cp -R /home/dspace/dspace-base/webapps/solr/ /home/dspace/apache-tomcat-version/webapps/
 +
cp -R /home/dspace/dspace-base/webapps/oai/ /home/dspace/apache-tomcat-version/webapps/</pre>
 +
 +
*Inciar o '''Tomcat''':
 +
 +
<pre>/home/dspace/apache-tomcat-version/bin/startup.sh</pre>
  
 
== Configurações pós-instalação e considerações finais ==
 
== Configurações pós-instalação e considerações finais ==
 +
Procurar algumas das configurações citadas abaixo na seção sobre [http://wiki.ibict.br/index.php/Formul%C3%A1rio_de_entrada Formulários de entrada] dessa wiki.
 +
*Criar administador do repositório:
 +
<pre>/home/dspace/dspace-base/dspace create-admnistrator</pre>
  
[https://docs.google.com/document/d/1TGKcnDvGouGNgPb6itOWpAuknvmgJQSFR852qYq57G4/edit Documento do Google Docs]
+
*[https://docs.google.com/document/d/1os8e6KAQFOZCjGe_ralf7_J-G-lvOs6H9Weu6sQvAJU/edit?usp=sharing input-forms.xml]  
 +
*Edição do esquema de metadados
 +
*Filtros de buscas e facetas
 +
*dspace\config\item-submission.xml
 +
*Mudanças nas tags de tradução
 +
*As interfaces '''OAI''' e '''Solr'''
 +
*Pequenas customizações de layout ('''JSPUI''')
 +
*Upgrade de Versões (https://drive.google.com/file/d/0B6UBxTsnsN6LQXJjODJ6OWdteEVicFlnVUZJMS1VMm94eERN/edit?usp=sharing)
 +
*Comandos para se colocar na '''crontab''' (https://www.dropbox.com/s/t597mo26v331ns3/Usando%20cron%20e%20crontab%20para%20agendar%20tarefas.pdf):
 +
 
 +
<pre> /home/dspace/dspace-base/dspace oai import
 +
/home/dspace/dspace-base/dspace filter-media
 +
</pre>
 +
*Thumbnail
 +
*webui.strengths.show = true

Edição atual tal como às 17h02min de 14 de outubro de 2015

Índice

Criando infraestrutura para instalação do DSpace

O DSpace necessita de uma infraestrutura básica para seu pleno funcionamento, a saber:

- Apache-Ant (em sua versão binária, que pode ser baixada no site do projeto)

- Apache-Maven (em sua versão binária, que pode ser baixada no site do projeto)

- Apache-Tomcat (em sua versão binária, que pode ser baixada no site do projeto)

-Código fonte do DSpace

-Biblioteca JAI_IMAGEIO

-Biblioteca JAI_CORE

-XPDF

-PostgreSQL

Instalando PostgreSQL

Este pode ser instalado via apt-get, por meio de:

apt-get install postgresql

Anote a senha fornecida para o usuário dspace.

Instalando Java JDK 1.7.x

  • Primeiramente baixe o pacote JDK 7 no LINK. Se atente às configurações de seu sistema operacional (32 ou 64 bits).

-Consiga privilégios a partir do código:

sudo su

-Crie diretório para a instalação de seu pacote JAVA seguindo o código abaixo. O diretório /opt é reservado para todos os softwares e acréscimos de pastas que não fazem parte da instalação padrão.

mkdir /opt/jdk

-Extraia o pacote JAVA:

tar -zxf jdk-7u71-linux-x64.tar.gz -C /opt/jdk

-Por último, verifique se a extração foi efetuada com sucesso:

ls /opt/jdk
  • Instalando o Java

-Levando em consideração os passos acima, os executáveis necessários para a instalação do Java devem estar localizados no diretório: /opt/jdk/jdk1.8.0_05/bin/java. Para instalar na forma padrão, efetue:

update-alternatives --install /usr/bin/java java /opt/jdk/jdk1.x.x_xx/bin/java 100
update-alternatives --install /usr/bin/javac javac /opt/jdk/jdk1.x.x_xx/bin/javac 100
  • Verifique se a instalação foi efetuada com sucesso, ao efetuar cada update, a resposta abaixo de cada um deve estar de acordo com o que foi também informado:
update-alternatives --display java

"java - auto mode
link currently points to /opt/jdk/jdk1.x.x_xx/bin/java
/opt/jdk/jdk1.x.x_xx/bin/java - priority 100
Current 'best' version is '/opt/jdk/jdk1.x.x_xx/bin/java'."

update-alternatives --display javac

"javac - auto mode
link currently points to /opt/jdk/.x.x_xx/bin/javac
/opt/jdk/.x.x_xx/bin/javac - priority 100
Current 'best' version is '/opt/jdk/jdk1.x.x_xx/bin/javac'."
  • Outra forma de verificar se a instalação foi efetuada com sucesso, é:
java -version

"java version ".x.x_xx"
Java(TM) SE Runtime Environment (build .x.x_xx-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)"

Outras opções de instalação da Java JDK

Configurações iniciais

  • Criando usuário DSpace

O primeiro passo é a criação do usuário e grupo dspace para o Sistema Operacional. Isso é possível estando logado como root, e executando os seguintes comandos:

addgroup dspace
useradd –m dspace -g dspace
passwd dspace

Caso o sistema linux seja o CentOS, os comandos executados devem ser:

groupadd dspace
adduser –m dspace -g dspace
passwd dspace
  • Logando ao DSpace

Insira o comando

 su dspace 
  • Descompactando os pacotes necessários dentro da pasta /home/dspace:


-DSpace

tar -vzxf dspace-x.x-src-release.tar.gz

-Maven

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

-Ant

tar -vzxf apache-ant-x.x.x-bin.tar.gz

-Tomcat

tar -vzxf apache-tomcat-x.x.x-bin.tar.gz

-jai_imageio

tar -vzxf jai_imageio-1_1-lib-linux-i586.tar.gz

-jai_core

unzip jai_core-1.1.2_01.jar.zip
  • Caso acuse o erro: "unzip: comando não encontrado", baixe o programa que permita extração do arquivo:
    apt-get install unzip

-XPDF

tar -vzxf xpdfbin-linux-3.04.tar.gz
  • Caso a rede esteja sobproxy, faz-se necessário:

Criação de diretório .m2 dentro da pasta /home/dspace, e criação de arquivo xml sob nome de settings.xml, que por sua vez deve conter as seguintes linhas de código:


<settings>
       <proxies>
         <proxy>
           <active>true</active>
           <protocol>http</protocol>
           <host>10.1.1.1</host>
           <port>80</port>
           <username>username</username>
           <password>password</password>
           <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
         </proxy>
       </proxies>
</settings>
  • Mudar a codificação do Tomcat por meio de edição d arquivo home/dspace/apache-tomcat-x.x.x/conf/server.xml:
Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" URIEncoding="UTF-8" 
  • Edite o arquivo /etc/postgresql/x.x/main/postgresql.conf e retire o # da linha:
#listen_addresses = 'localhost'
  • Edite também o arquivo /etc/postgresql/x.x/main/pg_hba.conf e insira ao final dele a linha:
host all all 127.0.0.1 255.255.255.255 md5
  • Crie o usuário dspace no PostgreSQL:
su postgres
createuser –d –A –P dspace
exit
  • Estando logado como dspace, crie a base dados:
createdb –E UNICODE [nome-da-base-de-dados]

Pré-Instalação

  • Definindo parâmetros para o arquivo dspace-x.x-src-release/build.properties:


Tag Comentário
dspace.install.dir=/home/dspace/dspace-base coloque no lugar de /dspace o caminho da pasta escolhida para instalação do sistema.
dspace.baseUrl = http://localhost:8080 este é o endereço de sua página. Substituahttp://localhost:8080 pela URL do seu site. Caso seu servidor Apache-Tomcat esteja configurado para responder em um porta diferente da porta 80 (que é a padrão do protocolo http) é necessário informar também o número da porta para a conexão. Por exemplo: http://www.meusite.com.br:8080..
dspace.name = DSpace at My University este é nome do repositório, que aparecerá na página principal da interface de usuário..
solr.server=http://localhost:8080/solr este parâmetro indica qual é endereço da aplicaçãosolr. Esta opera em importantes tarefas, como o sistema de estatísticas e a busca facetada.
default.language = pt_BR o idioma padrão do repositório:
  • pt_BR para português brasileiro,
  • pt para português de Portugal,
  • en para inglês,
  • es para espanhol, ...
db.name=postgres O sistema de banco de dados que será utilizado. As principais opções são postgres e oracle.
db.driver=org.postgresql.Driver Esta é declaração do driver de conexão com o banco.
db.url=jdbc:postgresql://localhost:5432/dspace Endereço de conexão com o banco. É necessário alterar o nome dspace para o nome utilizado para base de dados.
db.username=dspace Usuário de conexão com o banco, em geral este será dspace.
db.password=dspace Senha escolhida para o usuário do banco.
mail.server = smtp.example.com Endereço do servidor smtp de email.
mail.server.username= Usuário para conexão com o servidor de email.
mail.server.password= Senha para conexão com o servidor de email.
mail.server.port = 25 Porta de conexão com o servidor de email.
mail.from.address = dspace-noreply@myu.edu Endereço que aparecerá no campo ' enviado por ' nos emails emitidos pelo repositório.
mail.feedback.recipient = dspace-help@myu.edu Endereço que receberá os feedbacks de usuário.
mail.admin = dspace-help@myu.edu Endereço do administrador do repositório.
mail.alert.recipient= Email que receberá os alertas sobre problemas no banco.
mail.registration.notify= Email que receberá notificações sobre registros de novos usuários no repositório.
#handle.canonical.prefix = ${dspace.url}/handle/ Endereço do servidor de handle. Quanto se utiliza o próprio repositório para gerar as URLs que remeterão aos arquivos do repositório, deve-se retirar o comentário ' # ' desta linha.

Atenção: Substitua também a palavra dspace.url por dspace.baseUrl

handle.canonical.prefix = http://hdl.handle.net/ Se estiver utilizando o serviço de um servidor handle externo, deve-se substituir http://hdl.handle.net/ pelo endereço deste servidor. Caso tenha optado por utilizar o servidor handle nativo do DSpace, deve-se comentar esta linha, colocando um # no início dela.
handle.prefix = 123456789 Este é o prefixo que aparecerá em todos os endereços dos arquivos do repositórop. Substitua o número 123456789 por um número conveniente.
  • Moficando o dspace-4.x-src-release/dspace/config/dspace.cfg para geração de thumbnails. Procurar pela tag filter.plugins = e modificá-la conforme descrito abaixo:
xpdf.path.pdftotext =[camimho-para-a-pata-bin-do-xpdf]/pdftotext
xpdf.path.pdftoppm =[camimho-para-a-pata-bin-do-xpdf]/pdftoppm
xpdf.path.pdfinfo =[camimho-para-a-pata-bin-do-xpdf]/pdfinfo

filter.plugins = \
***PDF Text Extractor, \
***PDF Thumbnail, \
HTML Text Extractor, \
Word Text Extractor, \
JPEG Thumbnail

Faz-se necessário a substituição da linhas destacadas por ***

#Assign 'human-understandable' names to each filter
plugin.named.org.dspace.app.mediafilter.FormatFilter = \
***  org.dspace.app.mediafilter.XPDF2Text = PDF Text Extractor, \
***  org.dspace.app.mediafilter.XPDF2Thumbnail = PDF Thumbnail, \
  org.dspace.app.mediafilter.HTMLFilter = HTML Text Extractor, \
  org.dspace.app.mediafilter.WordFilter = Word Text Extractor, \
  org.dspace.app.mediafilter.PowerPointFilter = PowerPoint Text Extractor, \
  org.dspace.app.mediafilter.JPEGFilter = JPEG Thumbnail, \
  org.dspace.app.mediafilter.BrandedPreviewJPEGFilter = Branded Preview JPEG

#Configure each filter's input format(s)
***  filter.org.dspace.app.mediafilter.XPDF2Thumbnail.inputFormats = Adobe PDF
***  filter.org.dspace.app.mediafilter.XPDF2Text.inputFormats = Adobe PDF
filter.org.dspace.app.mediafilter.PDFFilter.inputFormats = Adobe PDF
filter.org.dspace.app.mediafilter.HTMLFilter.inputFormats = HTML, Text
filter.org.dspace.app.mediafilter.WordFilter.inputFormats = Microsoft Word
filter.org.dspace.app.mediafilter.PowerPointFilter.inputFormats = Microsoft Powerpoint, Microsoft Powerpoint XML
filter.org.dspace.app.mediafilter.JPEGFilter.inputFormats = BMP, GIF, JPEG, image/png
filter.org.dspace.app.mediafilter.BrandedPreviewJPEGFilter.inputFormats = BMP, GIF, JPEG, image/png

Gerando o pacote binário e ativando o DSpace

  • Compilar as bibliotecas jai_imageio e jai_core. Estando dentro da pasta /home/dspace, executar os comandos:
apache-maven-x.x.x/bin/mvn install:install-file \
-Dfile=jai_core-1.1.2_01.jar \
-DgroupId=javax.media \
-DartifactId=jai_core -Dversion=1.1.2_01 \
-Dpackaging=jar \
-DgeneratePom=true

apache-maven-x.x.x/bin/mvn install:install-file \
-Dfile=jai_imageio-1_1/lib/jai_imageio.jar \
-DgroupId=com.sun.media \
-DartifactId=jai_imageio \
-Dversion=1.0_01 \
-Dpackaging=jar \
-DgeneratePom=true
  • Compilar o código do DSpace. Estando dentro da pasta /dspace-x.x-src-release, executar os comandos:
apache-maven-x.x.x/bin/mvn -Pxpdf-mediafilter-support -U clean package
    • 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
  • Executar a instalação via software Ant:
apache-ant-x.x.x/bin/ant fresh_install
  • Uma falha bastante comum, nesse processo, é o erro de permissão de escrita na pasta definida no dspace.install.dir=/dspace-base do arquivo build.properties. Portanto para se certificar que o diretório destino de instalação está com permissões de escrita ao usuário dspace, deve-se logar como root e executar o comandos:
mkdir /dspace-base
chown dspace:dspace /dspace-base
  • Copiar as aplicações para dentro do Tomcat:
cp -R /home/dspace/dspace-base/webapps/jspui/ /home/dspace/apache-tomcat-version/webapps/
cp -R /home/dspace/dspace-base/webapps/solr/ /home/dspace/apache-tomcat-version/webapps/
cp -R /home/dspace/dspace-base/webapps/oai/ /home/dspace/apache-tomcat-version/webapps/
  • Inciar o Tomcat:
/home/dspace/apache-tomcat-version/bin/startup.sh

Configurações pós-instalação e considerações finais

Procurar algumas das configurações citadas abaixo na seção sobre Formulários de entrada dessa wiki.

  • Criar administador do repositório:
/home/dspace/dspace-base/dspace create-admnistrator
 /home/dspace/dspace-base/dspace oai import
 /home/dspace/dspace-base/dspace filter-media
  • Thumbnail
  • webui.strengths.show = true