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

De IBICT
Ir para: navegação, pesquisa
(→‎Criação da pasta de instalação)
 
(42 edições intermediárias de um usuário não apresentadas)
Linha 86: Linha 86:
 
É 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:
 
É 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>
+
<pre>mkdir /[nome-da-pasta-base-de-instalação]
 +
chown dspace /dspace</pre>
  
 
Onde '''[nome-da-pasta-base-de-instalação]''' representa o nome escolhido para referida pasta.
 
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 ===
 
=== Configuração do PostgreSQL e criação do usuário '''dspace''' para a base de dados ===
Linha 142: Linha 142:
  
  
−
Se estiver utilizando um servidor '''proxi''' que impeça download direto sem autenticação, crie, dentro de '''/home/dspace''', a pasta '''.m2''':
+
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>
 
<pre>mkdir .m2</pre>
  
−
Copie o arquivo [http://devds-01.ibict.br/wiki/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 '''proxi'''.
+
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 ===
 
=== Configurando o Apache-Tomcat ===
Linha 184: Linha 184:
 
| '''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.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'''
+
| '''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'''
+
| '''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'''
+
| '''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'''
+
| '''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'''
+
| '''db.driver=org.postgresql.Driver''' || esta é declaração do driver de conexão com o banco.
 
|-
 
|-
−
| '''db.url=jdbc:postgresql://localhost:5432/dspace'''
+
| '''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'''
+
| '''db.username=dspace''' || usuário de conexão com o banco, em geral este será '''dspace'''.
 
|-
 
|-
−
| '''db.password=dspace'''
+
| '''db.password=dspace''' || senha escolhida para o usuário do banco.
 
|-
 
|-
−
| '''db.schema = '''
+
| '''db.schema = '''       || quando existe mais de um esquema de banco de dados, é necessário informar qual é o esquema padrão.
 
|-
 
|-
−
| '''db.maxconnections = 30 '''
+
| '''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 '''
+
| '''db.maxwait = 5000 ''' || tempo máximo de espera (em milesegundos, '''5000ms = 5s''') nas requisições de conexão com o banco.
 
|-
 
|-
−
| '''db.maxidle = -1 '''
+
| '''db.maxidle = -1 ''' || número máximo de conexões '''idle''' em '''pool''' no banco.
 
|-
 
|-
−
| '''db.statementpool = true '''
+
| '''db.statementpool = true ''' || haverá cache para as conexões em '''pool'''.
 
|-
 
|-
−
| '''db.poolname = dspacepool '''
+
| '''db.poolname = dspacepool ''' || nome dado para as conexões em '''pool'''.
 
|-
 
|-
−
| '''mail.server = smtp.example.com '''
+
| '''mail.server = smtp.example.com ''' || endereço do servidor '''smtp''' de email.
 
|-
 
|-
−
| '''mail.server.username= '''
+
| '''mail.server.username= ''' || usuário para conexão com o servidor de email.
 
|-
 
|-
−
| '''mail.server.password= '''
+
| '''mail.server.password= ''' || senha para conexão com o servidor de email.
 
|-
 
|-
−
| '''mail.server.port = 25 '''
+
| '''mail.server.port = 25 ''' || porta de conexão com o servidor de email.
 
|-
 
|-
−
| '''mail.from.address = dspace-noreply@myu.edu '''
+
| '''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 '''
+
| '''mail.feedback.recipient = dspace-help@myu.edu ''' || endereço que receberá os '''feedbacks''' de usuário.
 
|-
 
|-
−
| '''mail.admin = dspace-help@myu.edu '''
+
| '''mail.admin = dspace-help@myu.edu ''' || endereço do administrador do repositório
 
|-
 
|-
−
| '''mail.alert.recipient= '''
+
| '''mail.alert.recipient= ''' || email que receberá os alertas sobre problemas no banco.
 
|-
 
|-
−
| '''mail.registration.notify= '''
+
| '''mail.registration.notify= ''' || email que receberá notificações sobre registros de novos usuários no repositório.
 
|-
 
|-
−
| '''#handle.canonical.prefix = ${dspace.url}/handle/'''
+
| '''#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. {{Advert|Substitua também a palavra '''dspace.url''' por '''dspace.baseUrl'''}}.
 
|-
 
|-
−
| '''handle.canonical.prefix = http://hdl.handle.net/'''
+
| '''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'''
+
| '''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 ='''
+
| '''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 ='''
+
| '''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.1-src-release/''' e execute o comando:
 +
 +
<pre>/home/dspace/apache-maven-vesion/bin/mvn -U package</pre>
 +
 +
{{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 ===
 
=== Executando o Install ===
 +
 +
Se tudo correu bem, no processo de compilação o Maven criou a pasta '''dspace-3.1-src-release/dspace/target/dspace-3.1-build/'''. Vá até ela e execute o comando:
 +
 +
<pre>/home/dspace/apache-ant-version/bin/ant fresh_install</pre>
 +
 +
{{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 conteúdo pasta '''webapps''' da pasta instalação base do repositório:
 +
 +
<pre>cp -R /dspace-base/webapps/* /home/dspace/apache-tomcat-version/webapps</pre>
 +
 +
E realizar a inicialização do Apache-Tomcat:
 +
 +
<pre>/home/dspace/apache-tomcat-version/bin/startup.sh</pre>
 +
 +
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''').
 +
 +
{{Advert|'''Antes de se iniciar o uso do repositório''' é fortemente recomendável que se execute os seguintes passos.}}
 +
 +
Dentro da pasta '''/dspace-base/bin/''':
 +
 +
<pre>./dspace index-init
 +
./dspace index-update
 +
./dspace update-discovery-index</pre>
 +
 +
E para criação do usuário administrador do repositório:
 +
 +
<pre>./dspace create-administrator</pre>

Edição atual tal como às 15h48min de 2 de agosto 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.

Í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].

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

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

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.

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:
  • 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, 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.

Warning.gif 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.
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.1-src-release/ e execute o comando: 

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

Notepad.gif 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.1-src-release/dspace/target/dspace-3.1-build/. Vá até ela e execute o comando: 

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

Notepad.gif 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 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).

Warning.gif 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
Disponível em "http://wiki.ibict.br/index.php?title=Instalação_do_DSpace_3.1&oldid=291"