1. Curso DSpace Desenvolvimento e Administrao de Repositrios Digitais Vania Santos e Rodrigo Prado de Jesus So Paulo, 2014 Mdulo Instalao do DSpace - Windows Av. Paulista, n. 726 17 andar http://www.quatroelementos.com.br Fone: + 55 11 4506-3226 cursos@quatroelementos.com.br rodrigo@quatroelementos.com.br

2. Objetivos do Mdulo Ao final deste mdulo, voc ser capaz de: Instalar a infra-estrutura de software necessria para o DSpace Fazer as configuraes bsicas para instalao do DSpace Instalar o DSpace em ambiente Microsoft Windows 3. Pr-requisitos para instalao Antes de iniciar a instalao do DSpace necessrio preparar a infraestrutura de software para o pleno funcionamento do sistema. Os aplicativos que devem ser instalados so os seguintes: JDK - Java Development Kit Apache Maven Apache Ant Servidor de banco de dados - PostgreSQL ou Oracle Servidor de aplicao Tomcat, Jetty, Glassfish, etc. 4. JDK - Java Development Kit O DSpace um aplicativo desenvolvido com a utilizao da linguagem de programao Java. Assim, ser necessria a instalao de uma maquina virtual Java. O DSpace precisa da verso do JDK 6 ou mais recente para rodar. A ltima verso disponvel pode ser obtida no endereo: http://www.oracle.com/technetwork/java/javase/downloads/index.html 5. Apache Maven Apache Maven uma ferramenta para gerenciamento e automao de projetos em Java. O Apache Maven necessrio na primeira fase do processo de compilao do DSpace para montar o pacote de instalao do sistema. A ltima verso do Apache Maven pode ser obtida no endereo: http://maven.apache.org/download.html 6. Apache Ant Apache Ant uma ferramenta de linha de comando para construir aplicaes em Java. Ele fornece diversas tarefas para compilar, montar, testar e executar programas em Java. A ltima verso do Apache Ant pode ser obtida no endereo: http://ant.apache.org/bindownload.cgi 7. PostgreSQL O PostgreSQL um servidor de banco de dados de cdigo aberto que roda em diversos sistemas operacionais. Possui suporte completo para chaves estrangeiras, joins, views, triggers e procedures. A ltima verso do PostgreSQL pode ser obtida no endereo: http://www.postgresql.org/download/ 8. Apache Tomcat Apache Tomcat um servidor de aplicao Java que implementa as tecnologias Java Servlet e Java Server Pages. necessrio para hospedar a aplicao Dspace. A ltima verso do Apache Tomcat pode ser obtida no endereo: http://tomcat.apache.org/ 9. DSpace A ltima verso do DSpace pode ser obtida pelo endereo: http://www.dspace.org/latest-release/ 10. Instalao DSpace 11. Instalao DSpace - Windows Antes de iniciar a instalao certifique-se que voc baixou e salvou todos os pr-requisitos mencionados em uma pasta, como mostrado abaixo: 12. Instalao do JDK Para instalar o JDK, d um clique duplo no arquivo jdk-***-windows-***.exe, siga as instrues na tela e aceite o acordo de licena: 13. Instalao do Apache Ant Para instalar o Apache Ant, crie uma pasta chamada ant, por exemplo, no drive C: e extraia o contedo do arquivo apache-ant-***-bin.zip nessa pasta. 14. Instalao do Apache Maven Para instalar o Apache Maven, crie uma pasta chamada maven, por exemplo, no drive C: e extraia o contedo do arquivo apache-maven-***-bin.zip na pasta C:maven. 15. Definir variveis de ambiente Agora necessrio definir algumas variveis de ambiente para que o sistema encontre os programas instalados Adicionar varivel PATH: C:Program FilesJavajdk*.**bin;C:antbin;C:mavenbin Setar na varivel JAVA_HOME o valor: C:Program FilesJavajdk*** Setar na varivel ANT_HOME o valor: C:ant 16. Teste se tudo est funcionando Para testar se tudo est funcionando, execute os comandos abaixo no prompt de comando: > java version > ant version > mvn version 17. Instalao do PostgreSQL Para instalar o PostgreSQL, d um clique duplo no arquivo postgresql-***-windows.exe e siga as instrues do instalador. 18. Criao da base de dados para o DSpace Crie uma base de dados para o DSpace. Para fazer isso, execute o seguinte programa: Iniciar->Todos os programas->PostgreSQL ***->pgAdmin III Nessa janela, clique com o boto direito no seu servidor e clique em conectar, como mostrado abaixo: 19. Criao da base de dados para o DSpace Primeiro necessrio criar um usurio chamado dspace. Depois de expandir a conexo com o servidor, clicando em +, clique com o boto direito do mouse em Login Roles e em New Login Role conforme figura abaixo: 20. Criao da base de dados para o DSpace Agora crie um usurio chamado dspace com a senha desejada (neste caso, a senha dspace), como mostrado na tela seguinte e clique em OK. 21. Criao da base de dados para o DSpace Crie uma database chamada dspace colocando como owner o usurio dspace criado na etapa anterior, conforme mostra a figura abaixo e clique em OK. 22. Instalao do Apache Tomcat Para instalar o Apache Tomcat, d um clique duplo no arquivo apache-tomcat-***.exe e siga as instrues na tela. 23. Instalao do Apache Tomcat Ser solicitada a incluso do usurio e senha para acesso administrao do Tomcat, entre com esses dados conforme tela abaixo: 24. Instalao do Apache Tomcat Ser solicitada a definio da pasta onde o Tomcat ser instalado. Para essa instalao ns usamos a pasta C:Tomcat, conforme figura abaixo: Siga as instrues padres at que a instalao seja concluda 25. Iniciar a instalao do DSpace Antes de iniciar a instalao do DSpace, crie um diretrio para armazenar os arquivos do DSpace. Nesse caso, ns usaremos C:dspace 26. Iniciar a instalao do DSpace Extraia todo o contedo do arquivo dspace-***-src- release.zip numa pasta no drive C:. Nesse caso, ns usaremos a pasta C:dspace-***-src-release, conforme figura abaixo: 27. Iniciar a instalao do DSpace build.properties O arquivo build.properties contm as configuraes bsicas para instalao do DSpace pela primeira vez. Esse arquivo est localizado na pasta [dspace-source]. Faa as configuraes iniciais do DSpace , editando o arquivo build.properties. 28. build.properties - continuao dspace.install.dir - deve ser definido o diretrio de instalao do DSpace. dspace.hostname - nome completo do domnio do servidor web. dspace.baseUrl - URL completa da pgina inicial do DSpace dspace.name - Nome prprio do seu servidor, ex. Repositrio Digital da Universidade. default.language - linguagem padro para os metadados, ex. pt_BR. 29. build.properties - continuao db.name - banco de dados usado na aplicao DSpace (postgres or oracle). db.driver - Driver do banco de dados. db.url URL para conexo ao banco de dados. db.username - O usurio do banco de dados. db.password - A senha do banco de dados. mail.server - Nome completo do domnio do servidor de e- mail que ser usado pelo DSpace. mail.from.address - Endereo de e-mail a ser colocado como remetente nos e-mails enviados pelo DSpace. 30. build.properties - continuao mail.feedback.recipient - E-mail para receber feedbacks. mail.admin - E-mail do administrador do DSpace. mail.alert.recipient - E-mail para receber alertas/erros do servidor DSpace (no essencial, mas bem til). mail.registration.notify E-mail quando novos usurios se registram (opcional). Aps a edio do arquivo build.properties basta fechar e salvar o aquivo. 31. Construir o pacote de instalao Depois de ter editado e salvo o arquivo de configurao, abra o prompt de comando e v para a pasta C:dspace- ***-src-releasedspace Agora digite o comando mvn package e tecle enter A conexo com Internet necessria para executar essa operao, pois o Maven ir fazer o download de todas as dependncias necessrias para o DSpace. 32. Construir o pacote de instalao DSpace Caso voc tenha problemas nesse comando, verifique a pgina abaixo de como corrigir o erro [arquivo pom.xml]: https://github.com/DSpace/DSpace/pull/503/files Ao final da operao, voc receber a seguinte mensagem: 33. Instalar o DSpace e inicializar base de dados Agora no prompt de comando v para a pasta C:dspace- ***-src-releasedspacetargetdspace-***-build Execute o comando ant fresh_install. 34. Instalar o DSpace e inicializar base de dados Ao final da operao, voc receber a seguinte mensagem: 35. Criar usurio para administrao do DSpace Para criar uma conta para o administrador do sistema execute o seguinte comando e siga os passos solicitados: C:dspacebindspace create-administrator 36. Fazer deploy da aplicao Usando o Windows Explorer v at a pasta C:dspacewebapps 37. Fazer deploy da aplicao Copie as pastas jspui, oai, solr e xmlui para a pasta webapps do Tomcat. Ex: C:Program FilesApache Software FoundationTomcat 7.0webapps 38. Testar a aplicao DSpace Inicie o servio do Tomcat caso ele no esteja rodando. Abra as pginas http://localhost:8080/xmlui e http://localhost:8080/jspui no navegador. 39. Curso DSpace Desenvolvimento e Administrao de Repositrios Digitais Vania Santos e Rodrigo Prado de Jesus So Paulo, 2014 Fim do Mdulo Instalao do DSpace - Windows Av. Paulista, n. 726 17 andar http://www.quatroelementos.com.br Fone: + 55 11 4506-3226 cursos@quatroelementos.com.br rodrigo@quatroelementos.com.br