Mudanças entre as edições de "Instalação do DSpace 3.x"

Edição das 15h51min de 11 de setembro 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.

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

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

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.7.x. Uma lista de downloads para cada tipo de arquitetura pode ser encontrada em Download Java (você terá que efetuar um cadastro antes de baixar o arquivo).

Se optar pela instalação manual da máquina virtal Java é necessária a execução de alguns outros passos. Para instalação via apt-get siga a seguinte sequência:

• Acione as seguintes as linhas que seguem ao final do arquivo /etc/apt/sources.list:

#Java 7 (Oracle)
deb http://ppa.launchpad.net/webupd8team/java/ubuntu precise main
deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu precise main

• Execute os comandos:

apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886
apt-get update
apt-get install oracle-jdk7-installer

É 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]
chown dspace /dspace

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 proxy que impeça download direto sem autenticação, crie, dentro de /home/dspace, a pasta .m2:

mkdir .m2

Crie um arquivo de nome settings.xml, com o seguinte conteúdo, dentro da pasta .m2, e o edite, substituindo o IP, login, porta, e senha de acordo com os parâmetros de seu servidor proxy:

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

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.x-src-release.zip dentro da pasta /home/dspace/

unzip dspace-3.x-src-release

É necessário editar o arquivo dspace-3.x-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.

Após o término da configuração do arquivo build.properties, estando logado com o usuário de sistema operacional dspace, vá para pasta dspace-3.x-src-release/ e execute o comando:

/home/dspace/apache-maven-vesion/bin/mvn -U package

Executando o Install

Se tudo correu bem, no processo de compilação o Maven criou a pasta dspace-3.x-src-release/dspace/target/dspace-3.x-build/. Vá até ela e execute o comando:

/home/dspace/apache-ant-version/bin/ant fresh_install

Deve-se copiar o conteúdo pasta webapps da pasta instalação base do repositório:

cp -R /dspace-base/webapps/* /home/dspace/apache-tomcat-version/webapps

E realizar a inicialização do Apache-Tomcat:

/home/dspace/apache-tomcat-version/bin/startup.sh

O repositório estará disponível nos endereços http://www.meusite.com.br:8080/jspui (para interface de usuário jspui) ou http://www.meusite.com.br:8080/xmlui (para interface de usuário xmlui).

Isso pode ser feito por meio do comando:

export JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"

Para tornar esse dimensionamento permanente, basta inserir, ao final do arquivo /etc/profile, as seguintes linhas:

JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"
export JAVA_OPTS

Dentro da pasta /dspace-base/bin/:

./dspace index-init
./dspace index-update
./dspace update-discovery-index

E para criação do usuário administrador do repositório:

./dspace create-administrator