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

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

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:

• 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

• 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):

 /home/dspace/dspace-base/dspace oai import
 /home/dspace/dspace-base/dspace filter-media

• Thumbnail
• webui.strengths.show = true