Instalação do DSpace 3.x
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.
Índice |
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].
Preparando o ambiente
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 no site do projeto: http://www.dspace.org.
Infraestrutura básica
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: http://ant.apache.org/)
- Apache-Maven (em sua versão binária, que pode ser baixada no site do projeto: http://maven.apache.org/)
- Apache-Tomcat (em sua versão binária, que pode ser baixada no site do projeto: http://tomcat.apache.org/)
- PostgreSQL, este pode ser instalado via apt-get, por meio de:
apt-get install postgresql
E ainda é necessário baixar a máquina virtual Sun, ou Oracle, Java JDK 1.7.x.
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.
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.
| Tag | 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:
|
| 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, 5000ms = 5s) nas requisições de conexão com o banco. |
| db.maxidle = -1 | número máximo de conexões idle em pool no banco. |
| db.statementpool = true | haverá cache para as conexões em pool. |
| db.poolname = dspacepool | nome dado para as conexões em pool. |
| 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. |
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
NOTA: A execução deste processo demora em média de 15 à 30 min. Se tudo der certo, ao final aparecerá BUILD SUCCESSFUL
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
NOTA: A execução deste processo não deve passar de 10 min. Se tudo der certo, aparecerá novamente BUILD SUCCESSFUL
Deve-se copiar o as aplicações que deseja utilizar da webapps da instalação base do repositório. Exemplo:
cp -R /dspace-base/webapps/jspui /home/dspace/apache-tomcat-version/webapps/ cp -R /dspace-base/webapps/solr /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).
Atenção: Memória reservada para o servidor Apache-Tomcat - se houver muitas aplicações dentro da pasta webapps do Tomcat, ele pode travar, portanto é necessário que se reserve um conteúdo mínimo.
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
Atenção: Antes de se iniciar o uso do repositório é fortemente recomendável que se execute os seguintes passos.
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
