Manual de Instalao do DSpace

Elaborado por: Milton Shintaku

INTRODUO ..........................................................................................................................................3 PBLICO-ALVO.......................................................................................................................................3 O DSPACE..................................................................................................................................................3 PR-REQUISITOS....................................................................................................................................4 BANCO DE DADOS.....................................................................................................................................5 PostgreSQL.........................................................................................................................................5 Oracle .................................................................................................................................................5 SERVIDOR DE APLICAO (TOMCAT) .......................................................................................................6 PASSOS PARA UMA INSTALAO RPIDA EM SISTEMA LINUX/UNIX .................................7 ALGUMAS CONVENES: .........................................................................................................................7 POSTGRES:................................................................................................................................................8 ORACLE:...................................................................................................................................................9 CUSTOMIZAO INICIAL .........................................................................................................................10 INSTALANDO O DSPACE ..........................................................................................................................11 INSTALAO AVANADA .................................................................................................................13 TAREFAS AGENDADAS NA 'CRON' ...........................................................................................................13 O SERVIDOR DE IDENTIFICADORES (HANDLE SERVER) ...........................................................................15 BUGS CONHECIDOS ................................................................................................................................17 PROBLEMAS COMUNS .............................................................................................................................17 Erro de conexo com o banco de dados quando executa o ant fresh_install....................17 Tomcat no desativa .........................................................................................................................18 Problemas com a conexo com o banco de dados............................................................................19 As alteraes feitas nas pginas no aparecem na web. ..................................................................20

Introduo
Este um documento baseado na documentao tcnica do DSpace disponvel em: http://dspace.cvs.sourceforge.net/*checkout*/dspace/dspace/docs/install.html Este Manual trata dos procedimentos necessrios para a instalao do sistema DSpace e algumas configuraes necessrias para o pleno funcionamento do repositrio.

Pblico-alvo
Este manual tem como pblico-alvo os profissionais de informtica responsveis pela instalao, customizao e manuteno do Dspace na instituio. O perfil do profissional deve ser o mais prximo do administrador do servidor, onde ser instalado o repositrio. No processo de instalao, em muitos casos, ser necessrio executar comandos como superusurio (root). Comandos simples como cp copiar arquivos de um diretrio a outro ou complexos como o ant para compilar a aplicao devem ser executados durante a instalao, portanto, o profissional de informtica deve estar habituado com o ambiente Linux/Unix. A criao de usurio e base de dados outra tarefa a ser executada, para o banco PostGres. Essa tarefa pode ser executada pelos programas createuser e createDB localizados no diretrio bin. Caso opte pelo banco de dados Oracle, isso pode ser feito por ferramentas de administrao ou utilizando o programa SqlPlus. O tomcat fornece scripts para ativar (startup.sh) e desativar (shutdown.sh) no diretrio bin. Esses scripts facilitam nas tarefas e devem ser utilizados no processo de instalao.

O DSpace
O DSpace um sistema desenvolvido pelo Massachusetts Institute of Technology MIT em parceria com a Hewlett-Packard Company - HP e apoiado no Brasil pelo Instituto Brasileiro em Cincia e Tecnologia Ibict. O DSpace pertence categoria dos Repositrios Digitais RI e possui vrias facilidades implementadas para o pleno funcionamento desse conceito. O sistema possui uma estrutura de comunidades e colees para conter os itens de dados, desta forma facilita a organizao das informaes pertencentes ao repositrio. Baseado em trs processos bsicos (submisso, preservao e recuperao), o Dspace possibilita uma publicao de objetos digitais de maneira fcil e segura. O processo de submisso flexvel, e permite desde um auto-arquivamento at um processo de verificao - reviso - aceitao. O processo de submisso composto por

formulrios de fcil preenchimento que serviro para identificar o objeto digital (metadados baseados no Dublin Core). Em todos os passos da submisso, o sistema envia emails automticos que avisam as etapas concludas. Por ter como unidade os objetos digitais, o DSpace permite vrios tipos de objetos e tipos de arquivos, tais como: texto, imagem, udio e vdeo para os tipos de objetos digitais e todos os tipos mais comuns de arquivos como: PDF, DOC, TXT (para texto), JPG, GIF (para imagens), etc. A recuperao dos itens de dados pode ser feita de vrias maneiras: listas ordenadas por data, autores, comunidades, assuntos etc. O sistema apresenta tambm duas interfaces de busca: simples e avanada. O DSpace tambm implementa o provedor de dados pertencente iniciativa de arquivos abertos/livres. Assim sendo, permite que coletores automticos de metadados recolham os metadados pertencentes s colees e comunidades livres assim como os links para os objetos digitais.

Pr-requisitos
Para o funcionamento pleno do sistema DSpace necessria uma infraestrutura composta de um sistema operacional e alguns softwares adicionais. Como o DSpace foi desenvolvido no padro de cdigo aberto h inmeras possibilidades para a instalao. Neste Manual ser apresentada apenas uma dessas opes, baseada na experincia do MIT e do Ibict. No trataremos da instalao dos softwares necessrios ao funcionamento do DSpace, uma vez que essa informao pode ser obtida nos guias de instalao de cada componente. Entretanto, para facilitar o pleno funcionamento do DSpace apresentamos algumas configuraes necessrias. 1. 2. 3. 4. Sistema operacional baseados no UNIX (Linux, HP/UX etc) Java 1.4 ou mais recente (SDK padro, no necessrio o J2EE) Apache Ant 1.6.2 ou mais recente PostgreSQL 7.3 ou mais recente, ou Oracle 9 ou mais recente.

Banco de dados
PostgreSQL Para o melhor funcionamento do DSpace, o suporte ao Unicode

(especificamente o UTF-8) deve estar ativado. Esse procedimento padro nas verses 8.0+. Para a verso 7.x, assegure-se de compilar o banco com a seguinte opo no script de configurao: --enable-multibyte --enable-unicode --with-java Uma vez instalado, ser necessrio permitir as conexes com o TCP/IP (DSpace utiliza o JDBC). Para a verso 7.x, edite o arquivo postgresql.conf (geralmente est em um desses diretrios /usr/local/pgsql/data ou /var/lib/pgsql/data), e adicione essa linha: tcpip_socket = true Para verses do banco 8.0 e posteriores, no arquivo postgresql.conf descomente a linha (pode haver algumas diferenas, mas inicia-se por): listen_addresses = 'localhost' Para autorizar a conexo com o banco, deve-se editar o arquivo pg_hba.conf e adicionar a linha seguinte: host dspace dspace 127.0.0.1 255.255.255.255 md5 Agora, basta desativar e ativar o PostgreSQL para validar e ativar as modificaes. Oracle No Oracle, primeiramente ser necessrio criar uma base de dados para o DSpace. Assegure que a codificao do banco o Unicode. O DSpace utiliza o UTF8 nativamente; recomendado que a codificao, tanto do banco como do sistema, seja a mesma. Ser necessrio criar uma conta de usurio para o DSpace (pode-se criar com o nome dspace) e dar todas as permisses necessrias para criar e deletar tabelas na base de dados criada para o DSpace. Para ajud-lo, veja os passos de instalao para maiores detalhes.

NOTA: DSpace utiliza estruturas de seqncias (sequences) para gerar os identificadores seqncias: dos objetos valores Alguns cuidados so com necessrios um ao utilizar de Seus podem perder-se procedimento

exportar/importar; assegure-se de executar o script sequences.sql.

localizado em: /etc/update-

Outra Nota: Algumas verses de Oracle limitam os textos em 4K em seus campos de descrio de metadados ou descrio de coleo. Para aqueles que estiverem interessados em trocar o banco de dados de Postgres para Oracle, no existem facilidades para faz-lo automaticamente. Ser necessrio recriar toda a estrutura de comunidade, coleo e Epeople (usurios com capacidade de administrar e submeter itens de dados) no Oracle e depois importar os contedos. Servidor de aplicao (Tomcat) O DSpace deve ser executado com o mesmo usurio que ativa o servidor de aplicao Tomcat, desta forma, pode-se instalar e ativar o Tomcat com um usurio chamado DSpace, pois facilitar o gerenciamento e as permisses necessrias ao funcionamento do sistema. Assegure que o Tomcat tenha: a) Memria suficiente para executar o DSpace; b) Utilize o UTF-8 como codificao padro. Assegure-se que a opo abaixo descrita esteja ativa (isso evitar problemas com acentos nas transaes): JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8" Ser necessrio alterar a configurao padro do Tomcat para a busca e visualizao de caracteres UTF com mais de um byte. preciso adicionar a opo de configurao <Connector> no arquivo [tomcat]/config/server.xml: URIEncoding="UTF-8" O exemplo abaixo indica onde deve ser realizada a alterao: <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector port="8080"

maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8" />

Passos para uma instalao rpida em sistema LINUX/UNIX

Algumas convenes: O DSpace utiliza trs diretrios distintos. Para facilitar o entendimento, convencionaremos os nomes dos diretrios e daremos detalhes necessrios instalao: O diretrio fonte referenciado como: [dspace-fonte]; esse diretrio conter os fontes do sistema, onde foram descompactados os fontes baixados. Exemplo: /usr/home/dspace O diretrio de instalao referenciado como: [dspace]. Fica na raiz / , por isso a instalao precisa ser feita com o usurio root. O nome do diretrio ser informado no arquivo de configurao dspace.cfg que est no [dspace-fonte]/config Exemplo para um repositrio com sigla = RIT: /rit

O DSpace possui dois diretrios (raiz), um para o sistema web e outro para os aplicativos. O diretrio do sistema web gerenciado pelo Tomcat e ser criado na descompactao do arquivo [nome do arquivo].war. A localizao desse diretrio : [diretrio do Tomcat]/webapps/[nome do repositrio. O diretrio do Tomcat (diretrio de instalao) conhecido como $CATALINA_HOME. O arquivo [nome do arquivo].war na instalao padro possui o nome dspace.war, e pode ser mantido, mas, caso necessite instalar mais que um repositrio, deve-se renomear o arquivo antes de copi-lo ao diretrio do Tomcat. A sugesto colocar o nome igual sigla do repositrio.

Exemplo para um Tomcat instalado em: /usr/share/tomcat e a sigla do repositrio: rit /usr/share/tomcat/webapps/rit

Crie o usurio DSpace no sistema operacional. Este usurio deve ser o mesmo usurio que ativar o Tomcat: useradd -m [nome do usurio]

Exemplo para criar um usurio chamado dspace Useradd m dspace

Baixe o arquivo compactado do DSpace no site do Ibict ou em outro site (tenha cuidado com as verses e verifique se o sistema est em portugus). Para descompactar o arquivo realize a seguinte operao: gunzip -c [nome do arquivo compactado].tar.gz | tar -xf -

Procedimentos no Banco de Dados

Postgres: Copie o driver PostgreSQL JDBC (programa de acesso ao banco de dados PostGreSql) para o diretrio de instalao do DSpace. O Driver um arquivo com extenso jar. Na instalao padro do PostGreSql o arquivo do driver est no diretrio: [diretrio de instalao do postgres]/src/interfaces/jdbc/jars/ e possui o nome de: postgresql.jar. Caso no encontre o driver, ou deseja um mais recente, pode-se baix-lo diretamente do site do PostGreSql (http://jdbc.postgresql.org/download.html). Assegure-se de verificar se o driver compatvel com a verso do banco de dados PostGreSql e a linguagem de programao Java.

Crie o usurio do banco de dados. Esse usurio ser responsvel por criar a base de dados do repositrio. Um mesmo usurio poder criar vrias bases de dados. createuser -U [nome do usurio (preferencialmente use: DSpace)] -d -A -P [senha];

exemplo de criao do usurio createuser U dsapace d A P senha_dspace

Crie a base de dados com o mesmo nome do repositrio (de preferncia a sigla do repositrio); isso facilitar o gerenciamento, principalmente se tiver mais que um repositrio instalado:

createdb -U [nome usurio] -E UNICODE [nome da base de dados] exemplo da criao da base de dados rit pelo usurio de banco dspace create U dspace E UNICODE rit

Oracle: Copie o driver JDBC Oracle para: [dspace-fonte]/lib. Crie a base de dados para o DSpace. Assegure-se que a codificao seja o Unicode. Como o DSpace utiliza o UTF-8 como codificao padro, sugerimos que o banco Oracle utilize a mesma codificao para evitar problemas. Crie o usurio para o DSpace (exemplo: dspace) e assegure-se de dar as permisses necessrias para a criao e remoo de objetos de banco (como tabelas e ndices). Edite o arquivo de configurao [dspace-fonte]/config/dspace.cfg para alterar a base de dados (o padro PostGreSql): db.name db.url = oracle

= jdbc.oracle.thin:@//host:port/dspace

db.driver = oracle.jdbc.OracleDriver V para [dspace-source]/etc/oracle e copie os contedos para o diretrio pai. Sobrescreva a verso existente: cd dspace_source/etc/oracle cp * .. Agora os arquivos .sql especficos para Oracle esto no diretrio correto e seu arquivo de configurao dspace.cfg j est modificado para acessar o Banco Oracle.

Customizao inicial
Altere o arquivo de configurao [dspace-fonte]/config/dspace.cfg, para customizar o repositrio. Para isso, algumas opes que devero ser alteradas: dspace.dir Deve-se colocar o nome do diretrio [dspace]. O nome mais apropriado para esse diretrio o nome do repositrio, pois facilitar a identificao caso tenha ou venha a ter mais que um repositrio instalado. dspace.url URL para a pgina do repositrio. dspace.hostname Domnio fully-qualified (nome do servidor que hospedar o repositrio). dspace.name Nome do repositrio. ex. "Meu repositrio". db.password Senha do usurio de banco de dados criado num passo anterior. mail.server Nome do servidor de correio eletrnico. mail.from.address Email reponsvel por enviar as mensagens eletrnicas do repositrio. feedback.recipient Nome do usurio (email) que receber as mensagens eletrnicas para o repositrio. mail.admin O Email do usurio administrador do repositrio (webmaster). NOTA: O arquivo de configurao aceita variveis no lugar de valores, por exemplo, para colocar o mesmo valor de outro parmetro, pode-se referenci-lo (isso facilita o gerenciamento, pois se for mudar o valor, muda-se em apenas um lugar). Ex. Para colocar na varivel feedback.recipient o mesmo valor de mail.admin, pode-se fazer o seguinte: feedback.recipient = ${mail.admin}

10

Exemplo das opes: dspace.dir = /rit (diretrio base do sistema) dspace.url = http://www.repositorio.com/rit (endereo do sistema) dspace.hostname = servidor.com (nome do servidor do sistema) dspace.name = Repositrio Institucional de Teste (nome do sistema) db.name = postgre (informa qual o tipo de banco de dados) db.username = dspace (informa o nome do usurio de banco) db.password = senha_dspace (informa a senha de banco) mail.server = correio.repositorio.com (nome do servidor de email) mail.from.address = dspace@repositorio.com feedback.recipient = dspace@repositorio.com (pode ser o mesmo) mail.admin = webmaster@repositorio.com

Instalando o DSpace
1. Crie um diretrio para o repositrio (deve ser executado como usurio root). Esse diretrio o que denominamos de [dspace]. Uma boa opo colocar o nome igual ao usurio da base de dados (sigla do repositrio): mkdir [sigla do repositrio] chown dspace:dspace [sigla do repositorio]

Exemplo para um repositrio com sigla = rit Mkdir rit Chown dspace:dspace rit 1. Como usurio dspace (usurio UNIX) compile e instale o repositrio: cd [dspace-fonte] ant fresh_install

Caso esteja re-executando o comando ant, por causa de falhas na 1 execuo, para evitar erros, execute: ant clean para limpar os arquivos da instalao anterior.

11

Alguns dos erros mais comuns esto descritos, juntamente com as solues, no anexo Soluo dos problemas mais comuns na instalao. 1. Renomeie e copie o arquivo com o sistema DSpace (arquivos xxx.war) para o diretrio do tomcat: V ao diretrio (build) que contm os arquivos. cd build Renomeie os arquivos. Dspace.war o arquivo do sistema web e dspaceoai.war o arquivo do sistema que responde ao coletor automtico de metadados. mv dspace.war [sigla do repositrio].war mv dspace-oai.war [sigla do repositrio].war

Exemplo para um repositrio chamado rit

mv dspace.war rit.war mv dspace-oai.war rit-oai.war

Copie os arquivos para o diretrio do Tomcat cp [sigla do repositrio].war [tomcat]/webapps cp [sigla do repositrio]-oai.war [tomcat]/webapps

Exemplo para arquivos que foram renomeados para rit e com o diretrio do Tomcat em /usr/share/tomcat

cp rit.war usr/share/tomcat/webapps cp rit-oai.war usr/share/tomcat/webapps

12

Quando o Tomcat encontra um arquivo compactado do tipo war (Web ARchieve file) faz a descompresso e cria toda a Aplicao. 3.Crie o administrador do repositrio: ./[dspace]/bin/create-administrator

Esse script pede o email do administrador, senha e telefone. Pode ser executado para tantos quantos forem os administradores do repositrio.

4. Desative e ative o Tomcat para refletir o novo sistema. Para verificar se o processo instalao executou com xito todos os seus passos, utilize o endereo dado no arquivo de configurao dspace.cfg na varivel dspace.url. Para gerenciar o repositrio ser necessrio acessar o menu do administrador. Isso pode ser feito diretamente por meio do endereo http://[endereo do repositrio]/dspace-admin. Uma tela requerendo identificao (endereo de email) e senha, para a identificao, ser mostrada antes. Depois da identificao, a tela de administrador estar disponvel.

Instalao Avanada
Os passos de instalao acima so suficientes para disponibilizar o repositrio, porm outros procedimentos so necessrios para aperfeioar sua instalao. Tarefas agendadas na 'cron' Algumas facilidades oferecidas pelo Dspace necessitam de procedimentos regulares. Para que o sistema envie os emails que avisam de novos itens depositados, o script sub-daily deve ser executado. A indexao do texto completo necessita que os arquivos sejam lidos e indexados pelo script filter-media. Para fazer com que essas tarefas fiquem agendadas pode-se usar a tabela cron, para edit-la, bastando executar os seguintes comandos com o usurio dspace no sistema operacional: crontab -e

13

Esse comando abrir uma nova pgina, assim sendo, basta digitar as seguintes linhas: # Send out subscription e-mails at 01:00 every day 0 1 * * * [dspace]/bin/sub-daily # Run the media filter at 02:00 every day 0 2 * * * [dspace]/bin/filter-media # Run the checksum checker at 03:00 0 3 * * * [dspace]/bin/checker -lp # Mail the results to the sysadmin at 04:00 0 4 * * * [dspace]/bin/dsrun org.dspace.checker.DailyReportEmailer c

Nota: para salvar o que foi feito: tecle esc e depois :q Para abandonar tecle esc e depois q! Conforme a necessidade de cada instituio, a freqncia de execuo desses scripts pode ser alterada. O banco de dados PostGreSql pode melhorar sua performance com a execuo freqente do script chamado 'vacuuming', que otimiza os ndices e limpa os dados dos itens removidos. Utilize o usurio do PostGreSql e adicione a linha a crontab. O procedimento o mesmo do anterior, com usurio PostGreSql; Crontab e Uma tela aparecer e podero ser adicionadas as seguintes linhas: # Clean up the database nightly at 4.20am 20 4 * * * vacuumdb --analyze dspace > /dev/null 2>&1

Nota: para salvar o que foi feito: tecle esc e depois :q Para abandonar tecle esc e depois q! Para que os relatrios de estatsticas possam ser gerados regularmente, basta executar os scripts automaticamente. Coloque os scripts na tabela da cron, e mude a freqncia conforme a sua necessidade. # Run stat analyses 0 1 * * * [dspace]/bin/stat-general 0 1 * * * [dspace]/bin/stat-monthly 0 2 * * * [dspace]/bin/stat-report-general

14

0 2 * * * [dspace]/bin/stat-report-monthly Escolha a freqncia de execuo dos scripts de acordo com a sua necessidade, porm importante ressaltar que quanto maior for o espao de tempo entre as execues, maior ser o tempo de execuo do script tambm. Ajuste a anlise com o intervalo de execuo dos scripts de forma a dar os resultados esperados. Nota: Para executar os relatrios de estatsticas ser necessria a instalao da linguagem de programao Perl (http://www.perl.com/download.csp). Para maiores informaes sobre como adequar os relatrios estatsticos, veja o manual: Configurando os relatrios estatsticos do Sistema DSpace.

O servidor de identificadores (Handle Server)

Alguns esclarecimentos preliminares: No obrigatria a utilizao de um sistema de identificao CNRI, porm ser necessria alguma codificao extra para utilizar outra coisa. Enquanto no for implementado o servidor de identificadores, os identificadores sero criados pelo sistema no formato: hdl:123456789/24 e assim por diante. Esses identificadores no so permanentes, j que o sistema de identificadores permanentes no os reconhece, e outros repositrios em teste podem ter os mesmos identificadores. Para registrar os identificadores, deve-se registrar o prefixo com CNRI e incluir o servidor de identificadores no DSpace. Este servidor comunicar com o outros de forma a tornar nico seus identificadores. Caso queira utilizar o servidor de identificadores, basta obter o prefixo no site do central do CNRI http://www.handle.net e inclu-lo em seu repositrio de produo. O servidor recebe e responde pedidos de outros servidores via protocolo TCP pela porta 2641. Os programas do servidor de identificadores esto includos no DSpace em: [dspace-source]/lib/handle.jar. Nota: A mais nova verso do handle.jar no foi includa nessa distribuio devido s condies de licena. Caso prefira fazer a atualizao, leia o documento: New License Condition disponvel em: http://www.handle.net/upgrade_6-2_DSpace.html e decida se realmente ir

15

atualizar o programa. Para faz-lo, basta trocar a verso velha pela nova no diretrio [dspace-source]/lib e recriar o sistema (pode ser com o comando ant com opo update). Um script ajuda a criar uma configurao para os identificadores. Execute o script que est em: [dspace]/bin/make-handle-config, depois coloque os parmetros apropriados no arquivo de configurao dspace.cfg. Caso necessite de maiores informaes, leia a documentao em: installation instructions on handle.net (http://www.handle.net/hs_manual_18jan02/server_manual02.html). Observe as mudanas se preferir instalar sem usar o script: Em vez de executar (como indicado no Manual):

java -cp /hs/bin/handle.jar net.handle.server.SimpleSetup /hs/svr_1

Pode-se executar:

[dspace]/bin/dsrun net.handle.server.SimpleSetup [dspace]/handle-server

Assegure-se que o diretrio [diretrio do dspace]/handle-server seja o mesmo que o colocado no parmetro handle.dir do arquivo de configurao dspace.cfg. Edite o arquivo [dspace]/handle-server/config.dct para incluir as seguintes linhas na clusula "server_config":

"storage_type" = "CUSTOM" "storage_class" = "org.dspace.handle.HandlePlugin"

Essa clusula utilizada para que o servidor de identificadores possa pegar, localmente, os identificadores identificadores). Em qualquer abordagem escolhida, ative o servidor de identificadores [dspace]/bin/start-handle-server, como usurio DSpace. Uma vez gerada a conexo ser necessrio ir a http://hdl.handle.net/4263537/5014 para enviar o arquivo sitebndl.zip. Na pgina de envio deve-se informar o nome do contato, administradores etc. A instalao no continuar at todo o processo estar concludo. diretamente do DSpace (o repositrio gera os

16

Bugs Conhecidos
Em todos os projetos grandes como o DSpace a possibilidade de pequenos erros (bugs) grande. Em muitos casos aparecem at em instalaes estveis. As verses do sistema DSpace so liberadas quando esto estveis, mas seria quase impossvel conhecer todos os bugs e corrigi-los, porm a cada verso o nmero de bugs diminui. Uma documentao sobre os bugs conhecidos est no arquivo KNOWN_BUGS junto aos programas fonte do sistema. Consulte o DSpace bug tracker: http://sourceforge.net/tracker/?atid=119984&group_id=19984&func=browse source forge, para verificar os bugs corrigidos e relatar os que encontrou. no

Problemas comuns
Em um mundo ideal, qualquer um que seguisse os passos acima em qualquer ambiente operacional no encontraria nenhum problema, mas como o mundo ainda no ideal, essa sesso lista alguns problemas mais corriqueiros ao instalar o DSpace e suas solues. Erro de conexo com o banco de dados quando executa o ant fresh_install H duas possibilidades comuns de ocorrer isso:

[java] 2004-03-25 15:17:07,730 INFO org.dspace.storage.rdbms.InitializeDatabase @ Initializing Database [java] 2004-03-25 15:17:08,816 FATAL org.dspace.storage.rdbms.InitializeDatabase @ Caught exception: [java] org.postgresql.util.PSQLException: Connection refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections. [java] at

org.postgresql.jdbc1.AbstractJdbc1Connection.openConnection(AbstractJdbc1Connecti on.java:204) [java] at org.postgresql.Driver.connect(Driver.java:139)

Isso geralmente significa que um parmetro importante no banco PostGreSql no foi configurado (verifique os passos nas pginas anteriores). Outra razo pode

17

ser que talvez no se tenha desativado e ativado o banco PostGreSql depois da modificao. Assegure-se que os parmetros de banco db.username e db.password properties esto colocados corretamente no arquivo de configurao [dspacesource]/config/dspace.cfg. Um meio fcil de checar se o banco de dados est acessvel conexes TCP/IP executar o comando abaixo (na linha de comando):

psql -U [usurio do banco] -W -h localhost

Ao executar este comando aparecer uma requisio de senha. Ao entrar com a senha do usurio indicado no comando acima, uma conexo com o banco ser criada, permitindo que comandos para o PostGreSql possam ser executados. Para voltar ao ambiente do sistema operacional digite /q. Outro erro comum :

[java] 2004-03-25 16:37:16,757 INFO org.dspace.storage.rdbms.InitializeDatabase @ Initializing Database [java] 2004-03-25 16:37:17,139 WARN org.dspace.storage.rdbms.DatabaseManager @ Exception initializing DB pool [java] java.lang.ClassNotFoundException: org.postgresql.Driver [java] [java] [java] at java.net.URLClassLoader$1.run(URLClassLoader.java:198) at java.security.AccessController.doPrivileged(Native Method) at java.net.URLClassLoader.findClass(URLClassLoader.java:186)

Isso significa que o programa de conexo com o banco de dados (driver) no foi copiado para o local necessrio. Para resolver este problema, basta copiar o arquivo do driver para [dspace_fonte]/lib. Veja nos procedimentos de banco de dados a soluo completa. Tomcat no desativa totalmente Caso altere a configurao do sistema (algum parmetro no arquivo dspace.cfg, mensagem no arquivo Messages_pt_BR.properties ou cor e fonte de letras no arquivo styles.css.jsp) ser necessrio que o Tomcat seja desativado e reativado para que as alteraes apaream refletidas nas pginas. Caso as modificaes no apaream, verifique se o Tomcat foi desativado completamente,

18

pois pode ser que alguma conexo tenha permanecido ativa e seja necessria uma interveno para a sua desativao. Neste caso tente executar o comando:

ps -ef | grep java

Verifique se o processo Java do Tomcat continua ativo. Este problema pode ocorrer mesmo com o Tomcat desativado. Para resolv-lo, mate o processo (execute o comando kill, se necessrio utilize a opo -9) e depois reative o Tomcat novamente. Problemas com a conexo com o banco de dados Se ao acessar as pginas do repositrio, a conexo com o banco de dados falha, pode ser que uma conexo antiga que no foi finalizada corretamente est atrapalhando o funcionamento do sistema. Para verificar esse problema, no sistema operacional execute o comando:

ps -ef | grep postgres

Ento, pode aparecer algo como:

dspace 16325 1997 0 Feb 14 ? in transaction

0:00 postgres: dspace dspace 127.0.0.1 idle

Isso normal, o DSpace mantm um pool de conexes de banco aberto para reutilizao, pois dessa maneira evita a necessidade de criar uma conexo a cada utilizao tornando mais rpida. A conexo idle (ociosa) perfeitamente normal, a espera de uso. Em muitos casos, uma conexo com erro permanece ativa com uma query (consulta), por exemplo:

dspace 16325 1997 0 Feb 14 ?

0:00 postgres: dspace dspace 127.0.0.1 SELECT

O exemplo acima mostra uma conexo executando uma operao de select (query). Caso a conexo com a query persista e o repositrio opera normalmente, h uma grande probabilidade de ser um processo que no foi finalizado, tente matar o processo e parar e reativar o Tomcat.

19

As alteraes feitas nas pginas no aparecem na web. Para evitar que o Tomcat continue utilizando o diretrio da verso antiga do sistema e evitar problemas com as alteraes, mate o diretrio do sistema [tomcat//webapps/[sigla do repositrio] antes de copiar a nova verso do arquivo compactado [sigla do repositrio].war. A maneira mais segura de alterar as pginas e programas faz-la no diretrio fonte [dspace-fonte] utilizado na instalao. Para compilar as pginas e programas, e com isso gerar um novo arquivo compactado, use o comando a seguir:

Ant update.

20