Exibir código-fonte para Instalação do DSpace 3.1

A instalação aqui apresentada está baseada em sistemas operacionais GNU/Linux. Esta opção apóia-se na utilização de software livre, que está em conformidade com muitas instituições, principalmente as públicas.

== GNU/Linux Debian ==

Os exemplos aqui apresentados referem-se a distribuição Debian 6 ou 7, mas podem ser facilmente ajustados para qualquer outro sistema operacional com kernel Linux. 
A facilidade para instalar softwares foi um fator importante na escolha da Debian. pois a possibilidade de instalação de pacotes com o aplicativo “apt”, facilita a preparação da infra-estrutura necessária à instalação do próprio DSpace, visto que este sistema necessita de vários softwares base para o seu pleno funcionamento. 
Algumas informações, no entanto, podem ser úteis para a utilização do “apt”. Primeiramente, saber o importante é saber que APT é a sigla para "Advanced Packaging Tool", ou em português, ferramenta avançada de empacotamento. Essa ferramenta serve para instalar softwares, que foram empacotados, de forma simples, e que pode ser usado em linha de comando.
Nesse caso, a ferramenta apt utiliza fontes de pacotes de softwares. Uma listagem das localizações dessas listas pode ser vista no arquivo '''/etc/apt/sources.list'''. Em alguns casos, deve-se adicionar novos endereços de repositórios existentes na rede a esse arquivo, para se obter pacotes que não estão disponíveis na lista padrão. Assim, se for necessário edite e adicione novas localizações de pacotes. 
A utilização da ferramenta apt será tratada aqui de forma sucinta, sem grandes detalhes, apenas para dar a noção de como a usar. A instalação dar-se-á via comando '''apt-get install [nome-do-pacote]'''. A remoção, se for o caso, pode se dar com '''apt-get remove [nome-do-pacote]'''. Se precisar saber o nome de um pacote, dê o comando '''apt-cache search [parte do nome do pacote]'''.

== Pacote fonte do DSpace 3.1 == 

Antes de mais nada, é necessário que se obtenha o pacote com código fonte do DSpace, o qual, em sua última versão pode ser obtido por meio do link:

- [http://downloads.sourceforge.net/project/dspace/DSpace%20Stable/3.1/dspace-3.1-src-release.zip Pacote fonte do DSpace 3.1]

== Infraestrutura básica ==

O DSpace necessita de uma infraestrutura básica para seu pleno funcionamento, a saber:

- [http://ftp.unicamp.br/pub/apache//ant/binaries/apache-ant-1.9.1-bin.tar.gz Apache-Ant 1.9.1]

- [http://ftp.unicamp.br/pub/apache/maven/maven-3/3.0.5/binaries/apache-maven-3.0.5-bin.tar.gz Apache-Maven 3.0.5]

- [http://ftp.unicamp.br/pub/apache/tomcat/tomcat-7/v7.0.41/bin/apache-tomcat-7.0.41.tar.gz Apache-Tomcat 7.4.41]

- [http://www.enterprisedb.com/postgresql-924-binaries-linux32?ls=Crossover&type=Crossover PostgreSQL 9.2.4 / 32 bits]
ou [http://www.enterprisedb.com/postgresql-924-binaries-linux64?ls=Crossover&type=Crossover PostgreSQL 9.2.4 / 64 bits].
Na distribuição Debian você tem a opção de instalar o PostgreSQL por meio do comando:

<pre>apt-get install postgresql</pre>


E ainda é necessário baixar a máquina virtual Sun, ou Oracle, Java JDK 1.6.x, pois a versão 1.7.x ainda não é suportada. Uma lista de downloads para cada tipo de arquitetura pode ser encontrada em [http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR Java 6] (você terá que efetuar um cadastro antes de baixar o arquivo).

Para a distribuição Debian 6 ou 7, há a opção de se realizar a instalação do sun-java6 de forma bastante simples. Basta que se insira as linhas seguintes, ao final do arquivo '''/etc/apt/source.list''': 

<pre>deb http://ftp.br.debian.org/debian squeeze non-free

deb-src http://ftp.br.debian.org/debian/ squeeze main non-free</pre> 

E então se execute a seguinte sequência de comandos:

<pre>apt-get update</pre>

<pre>apt-get upgrade</pre>

<pre>apt-get install sun-java6-jdk</pre>

[[Se optar pela instalação manual da máquina virtal Java]] é necessária a execução de alguns outros passos. 


É bastante recomendável que realize também o download do arquivo [http://geolite.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz GeoLiteCity] pois este será utilizado no sistema de estatísticas de acesso por território geográfico. No processo de compilação do DSpace o Apache-Ant deveria baixar automaticamente este arquivo, no entanto em algumas situações isso não ocorre, então, por segurança, recomenda-se baixá-lo manualmente.


Por padrão, o DSpace não realiza captura automática das imagens das capas dos arquivos PDF's depositados, se desejar que essa facilidade seja implementada é necessário que se baixe os seguintes softwares:

- [ftp://ftp.foolabs.com/pub/xpdf/xpdfbin-linux-3.03.tar.gz XPDF]

- [http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-i586.tar.gz Java Advanced Imaging]

- [http://www.java2s.com/Code/JarDownload/jai/jai_core-1.1.2_01.jar.zip Java Avanced Imaging Core]


Aproveite também para instalar a ferramenta Unzip de descompactação de arquivos, porque ela será necessária:

<pre>apt-get install unzip</pre>


== A instalação propriamente dita ==

=== Criação do 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 se executando os seguintes comandos:

<pre>addgroup dspace</pre>

<pre>useradd –m dspace -g dspace</pre>

<pre>passwd dspace</pre>

Anote a senha fornecida para o usuário '''dspace'''.


=== Criação da pasta de instalação ===

É necessário criar a pasta base de instalação do DSpace. Recomenda-se que este diretório esta alocado na pasta raiz '''/'''. Estando logado como '''root''', execute o comando:

<pre>mkdir /[nome-da-pasta-base-de-instalação]</pre>

Onde '''[nome-da-pasta-base-de-instalação]''' representa o nome escolhido para referida pasta.


=== Configuração do PostgreSQL e criação do usuário '''dspace''' para a base de dados ===

[[Se estiver utilizando o pacote PostgreSQL binário]] os endereços dos arquivos de configuração serão diferentes.


Edite o arquivo '''/etc/postgresql/9.1/main/postgresql.conf''' e retire o '''#''' da linha:

<pre>#listen_addresses = 'localhost'</pre>


Edite também o arquivo '''/etc/postgresql/9.1/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>


Para criar o usuário '''dspace''' no PostgreSQL, como '''root''' execute a seguinte sequência de comandos:

<pre>su postgres

createuser –d –A –P dspace</pre>

Responda não à pergunta "esta role poderá criar novas roles?".


Execute os comandos:

<pre>exit

su dspace</pre>

E forneça a senha para logar como '''dspace'''.

Crie então a base de dados (nesse momento ainda vazia) por meio do seguinte comando. No lugar de '''[nome-da-base-de-dados]''' coloque o nome que desejar para sua base de dados sem os colchetes. É importante não utilizar caracteres especiais como $, %, /, -, etc:

<pre>createdb –E UNICODE [nome-da-base-de-dados]</pre>


=== Configurando o Apache-Ant ===

Estando logado como '''dspace''', copie e realize a descompactação do arquivo '''apache-ant-1.9.1-bin.tar.gz'''
dentro da pasta '''/home/dspace/'''

<pre>tar -vzxf apache-ant-1.9.1-bin.tar.gz</pre>

=== Configurando o Apache-Maven ===

Estando logado como '''dspace''', copie e realize a descompactação do arquivo apache-maven-3.0.5-bin.tar.gz dentro da pasta '''/home/dspace/'''

<pre>tar -vzxf apache-maven-3.0.5-bin.tar.gz</pre>


Se estiver utilizando um servidor '''proxy''' que impeça download direto sem autenticação, crie, dentro de '''/home/dspace''', a pasta '''.m2''':

<pre>mkdir .m2</pre>

Copie o arquivo [http://devds-01.ibict.br/Dwiki/images/5/51/Settings.xml settings.xml] para dentro da pasta '''.m2''', e o edite, substituindo o IP, login, porta, e senha de acordo com os parâmetros de seu servidor '''proxy'''.

=== Configurando o Apache-Tomcat ===

Estando logado como '''dspace''', copie e realize a descompactação do arquivo '''apache-tomcat-7.0.41.tar.gz'''
dentro da pasta '''/home/dspace/'''

<pre>tar -vzxf apache-tomcat-7.0.41.tar.gz</pre>

Edite o arquivo '''home/dspace/apache-tomcat-7.0.41/conf/server.xml''' adicionando o termo:

<pre>URIEncoding="UTF-8"</pre>

logo após '''redirectPort="8443"''' em:

<pre><Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="8443" /></pre>

=== Executando o Package ===

Estando logado como '''dspace''', copie e realize a descompactação do arquivo '''dspace-3.1-src-release.zip'''
dentro da pasta '''/home/dspace/'''

<pre>unzip dspace-3.1-src-release</pre>

É necessário editar o arquivo '''dspace-3.1-src-release/build.properties'''. Este é composto do conjunto mínimo de parâmetros para a concretização da instalação. Todas as tags que aqui aparecem ocorrem também no arquivo '''dspace.cfg''', porem a razão de se editar somente o '''build.properties''' é de que os demais arquivos de configuração do sistema possuem uma série de outros objetos que muitas vezes não interessam em um primeiro momento. A recomendação é a de que se realize a instalação padrão, alterando-se somente os parâmetros necessários, e em uma segunda etapa se realize as configurações específicas, o que se seguirá de uma instalação de atualização do sistema.

{| border=1

! width=30% | Tag !! width=40% | Comentário 
|-
|'''dspace.install.dir=/dspace-base''' || coloque no lugar de '''/dspace-base''' o caminho da pasta escolhida para instalação do sistema 
|-
| '''dspace.baseUrl = http://localhost:8080''' || este é o endereço de sua página. Substitua '''http://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.
|-
| '''db.schema = '''       || quando existe mais de um esquema de banco de dados, é necessário informar qual é o esquema padrão. 
|-
| '''db.maxconnections = 30 ''' || este é número máximo de conexões simultâneas ao repositório. Se ele é bastante utilizado, '''30''' será um número pequeno.
|-
| '''db.maxwait = 5000 ''' || tempo máximo de espera (em milesegundos) nas requisições de conexão com o banco.
|-
| '''db.maxidle = -1 '''
|-
| '''db.statementpool = true '''
|-
| '''db.poolname = dspacepool '''
|-
| '''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.
|-
| '''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.
|-
| '''http.proxy.host =''' || endereço IP do servidor '''proxy''', caso utilize um para possíveis conexões externas que o repositório terá que realizar. Ex.: '''10.7.7.7'''
|-
| '''http.proxy.port =''' || porta de conexão com o servidor '''proxy'''. Ex.: '''81'''.
|-
|}

=== Executando o Install ===