Mudanças entre as edições de "Instalação do DSpace 3.x"
Washington (disc | contribs) (→Infraestrutura básica) |
Washington (disc | contribs) (→Infraestrutura básica) |
||
| Linha 32: | Linha 32: | ||
| − | 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 [http://www.oracle.com/technetwork/java/javasebusiness/downloads] (você terá que efetuar um cadastro antes de baixar o arquivo). | + | 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 [http://www.oracle.com/technetwork/java/javasebusiness/downloads Download Java] (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''': | 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''': | ||
Edição das 17h05min de 27 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.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:
Infraestrutura básica
O DSpace necessita de uma infraestrutura básica para seu pleno funcionamento, a saber:
- 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).
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
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.
| 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 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).
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
