Mudanças entre as edições de "Instalação do DSpace 4.x"
(→Pré-Instalação) |
|||
(49 edições intermediárias de um usuário não apresentadas) | |||
Linha 1: | Linha 1: | ||
+ | == 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 [http://ant.apache.org/ site do projeto]) | ||
+ | |||
+ | - Apache-Maven (em sua '''versão binária''', que pode ser baixada no [http://maven.apache.org/ site do projeto]) | ||
+ | |||
+ | - Apache-Tomcat (em sua '''versão binária''', que pode ser baixada no [http://tomcat.apache.org/ site do projeto]) | ||
+ | |||
+ | -Código fonte do [http://www.dspace.org/latest-release '''DSpace'''] | ||
+ | |||
+ | -Biblioteca [http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-i586.tar.gz '''JAI_IMAGEIO'''] | ||
+ | |||
+ | -Biblioteca [http://www.java2s.com/Code/JarDownload/jai/jai_core-1.1.2_01.jar.zip '''JAI_CORE'''] | ||
+ | |||
+ | -[https://mirror.hmc.edu/ctan/support/xpdf/xpdfbin-linux-3.04.tar.gz '''XPDF'''] | ||
+ | |||
+ | -'''PostgreSQL''' | ||
=== Instalando PostgreSQL === | === Instalando PostgreSQL === | ||
+ | |||
+ | Este pode ser instalado via '''apt-get''', por meio de: | ||
+ | <pre>apt-get install postgresql</pre> | ||
+ | |||
+ | 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 [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: | ||
+ | <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. | ||
+ | <pre>mkdir /opt/jdk</pre> | ||
+ | -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> | ||
+ | |||
+ | *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: | ||
+ | |||
+ | <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 == | ||
+ | |||
+ | *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: | ||
+ | |||
+ | <pre>addgroup dspace | ||
+ | useradd –m dspace -g dspace | ||
+ | passwd dspace</pre> | ||
+ | |||
+ | 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 | ||
+ | |||
+ | <pre> su dspace </pre> | ||
+ | |||
+ | *Descompactando os pacotes necessários dentro da pasta '''/home/dspace''': | ||
+ | |||
+ | |||
+ | -DSpace | ||
+ | <pre>tar -vzxf dspace-x.x-src-release.tar.gz</pre> | ||
+ | -Maven | ||
+ | <pre>tar -vzxf apache-maven-x.x.x-bin.tar.gz</pre> | ||
+ | -Ant | ||
+ | <pre>tar -vzxf apache-ant-x.x.x-bin.tar.gz</pre> | ||
+ | -Tomcat | ||
+ | <pre>tar -vzxf apache-tomcat-x.x.x-bin.tar.gz</pre> | ||
+ | -jai_imageio | ||
+ | <pre>tar -vzxf jai_imageio-1_1-lib-linux-i586.tar.gz</pre> | ||
+ | -jai_core | ||
+ | <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 | ||
+ | <pre>tar -vzxf xpdfbin-linux-3.04.tar.gz</pre> | ||
+ | |||
+ | *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: | ||
+ | <pre> | ||
+ | |||
+ | <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> | ||
+ | </pre> | ||
+ | |||
+ | *Mudar a codificação do '''Tomcat''' por meio de edição d arquivo '''home/dspace/apache-tomcat-x.x.x/conf/server.xml''': | ||
+ | |||
+ | <pre> | ||
+ | Connector port="8080" protocol="HTTP/1.1" | ||
+ | connectionTimeout="20000" | ||
+ | redirectPort="8443" URIEncoding="UTF-8" </pre> | ||
+ | |||
+ | *Edite o arquivo '''/etc/postgresql/x.x/main/postgresql.conf''' e retire o '''#''' da linha: | ||
+ | |||
+ | <pre>#listen_addresses = 'localhost'</pre> | ||
+ | |||
+ | *Edite também o arquivo '''/etc/postgresql/x.x/main/pg_hba.conf''' e insira ao final dele a linha: | ||
+ | |||
+ | <pre>host all all 127.0.0.1 255.255.255.255 md5</pre> | ||
+ | |||
+ | *Crie o usuário ''dspace'' no '''PostgreSQ'''L: | ||
+ | |||
+ | <pre>su postgres | ||
+ | createuser –d –A –P dspace | ||
+ | exit</pre> | ||
+ | |||
+ | *Estando logado como ''dspace'', crie a base dados: | ||
+ | |||
+ | <pre>createdb –E UNICODE [nome-da-base-de-dados]</pre> | ||
== 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 == | ||
+ | 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/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 18h02min 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:
|
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):
- Caso não apareça a mensagem BUILD SUCCESSFUL, um erro que pode ocorrer nesse momento, é erro de alocação de memória:
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