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

Índice

1 Criando infraestrutura para instalação do DSpace
- 1.1 Instalando PostgreSQL
- 1.2 Instalando Java JDK 1.7.x
2 Configurações iniciais
3 Pré-Instalação
4 Gerando o pacote binário e ativando o DSpace
5 Configurações pós-instalação e considerações finais

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

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

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

Índice

Criando infraestrutura para instalação do DSpace

Instalando PostgreSQL

Instalando Java JDK 1.7.x

Configurações iniciais

Pré-Instalação

Gerando o pacote binário e ativando o DSpace

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

Menu de navegação

Ferramentas pessoais

Espaços nominais

Variantes

Visualizações

Ações

Pesquisar

Navegação

Ferramentas