Mudanças entre as edições de "Instalação do DSpace 3.1"

Edição das 10h07min de 18 de julho de 2013

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.

Vantagens da opção 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:

- Pacote fonte do DSpace 3.1

Infraestrutura básica

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

- Apache-Ant 1.9.1

- Apache-Maven 3.0.5

- Apache-Tomcat 7.4.41

- PostgreSQL 9.2.4 / 32 bits ou PostgreSQL 9.2.4 / 64 bits. Na distribuição Debian você tem a opção de instalar o PostgreSQL por meio do comando:

apt-get install postgresql

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

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

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

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

apt-get update

apt-get upgrade

apt-get install sun-java6-jdk

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

- XPDF

- Java Advanced Imaging

- Java Avanced Imaging Core

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

apt-get install unzip

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:

addgroup dspace

useradd –m dspace -g dspace

passwd dspace

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:

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

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:

#listen_addresses = 'localhost'

Edite também o arquivo /etc/postgresql/9.1/main/pg_hba.conf e insira ao final dele a linha:

host all all 127.0.0.1 255.255.255.255 md5

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

su postgres

createuser –d –A –P dspace

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

Execute os comandos:

exit

su dspace

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:

createdb –E UNICODE [nome-da-base-de-dados]

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/

tar -vzxf apache-ant-1.9.1-bin.tar.gz

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/

tar -vzxf apache-maven-3.0.5-bin.tar.gz

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

mkdir .m2

Copie o arquivo 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 proxi.

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/

tar -vzxf apache-tomcat-7.0.41.tar.gz

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

URIEncoding="UTF-8"

logo após redirectPort="8443" em:

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

connectionTimeout="20000"

redirectPort="8443" />

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/

unzip dspace-3.1-src-release

É 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.

Executando o Install