Instalação do DSpace 4.x

De IBICT
Ir para: navegação, pesquisa

Í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