Instalação do DSpace 4.x
Índice |
Cirando 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-8u5-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.8.0_05/bin/java 100 update-alternatives --install /usr/bin/javac javac /opt/jdk/jdk1.8.0_05/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.8.0_05/bin/java /opt/jdk/jdk1.8.0_05/bin/java - priority 100 Current 'best' version is '/opt/jdk/jdk1.8.0_05/bin/java'." update-alternatives --display javac "javac - auto mode link currently points to /opt/jdk/jdk1.8.0_05/bin/javac /opt/jdk/jdk1.8.0_05/bin/javac - priority 100 Current 'best' version is '/opt/jdk/jdk1.8.0_05/bin/javac'."
- Outra forma de verificar se a instalação foi efetuada com sucesso, é:
java -version "java version "1.8.0_05" Java(TM) SE Runtime Environment (build 1.8.0_05-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
- 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
-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
- 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:
|
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-3.x-src-release/dspace/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
- Executar a instalação via software Ant:
apache-ant-x.x.x/bin/ant fresh_install
- 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 (https://docs.google.com/document/d/1os8e6KAQFOZCjGe_ralf7_J-G-lvOs6H9Weu6sQvAJU/edit?usp=sharing)
- 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