|
|
# Como instalar e configurar o sistema DSpace
|
|
|
|
|
|
### 1. Instalação das dependências:
|
|
|
<pre>$ sudo apt-get install tomcat7 postgresql openjdk-7-jdk maven ant</pre>
|
|
|
```bash
|
|
|
$ sudo apt-get install tomcat7 postgresql openjdk-7-jdk maven ant
|
|
|
```
|
|
|
|
|
|
### 2. Download do código-fonte
|
|
|
* Opção 1) Utilizando o Git
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ git config --global http.sslVerify false
|
|
|
$ git clone <ENDERECO_GIT_DO_PROJETO>
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
* Opção 2) Diretamente pela página Git do projeto. Basta entrar na página, fazer o download e descompactar o pacote baixado.
|
|
|
|
|
|
### 3. Criação e configuração do banco de dados
|
|
|
|
|
|
Para criar o usuário e o banco de dados no Postgres execute os seguintes comandos:
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ createuser -h localhost -U postgres --no-superuser --pwprompt [USUARIO_BD]
|
|
|
$ createdb -h localhost -U postgres -O [USUARIO_BD] [NOME_BD]
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
Para executar os comandos acima é necessário a senha do usuário “postgres”. Caso não saiba qual é a senha, execute os comandos abaixo para reconfigurar a senha.
|
|
|
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ sudo service postgresql start
|
|
|
$ sudo su postgres
|
|
|
$ psql -c "ALTER USER postgres WITH PASSWORD '[SENHA]' ;"
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
### 4. Configuração dos parâmetros de compilação e execução do sistema
|
|
|
|
|
|
As principais configurações do DSpace estão armazenadas no arquivo <DIR_SRC>/build.properties, como o diretório de instalação, URL e informações do banco de dados. Dentre essas, as mais importantes são:
|
|
|
|
|
|
* Diretório onde o DSpace será instalado:
|
|
|
<pre>
|
|
|
```bash
|
|
|
dspace.install.dir = [DIR_INSTALACAO]
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
* Informações sobre o banco de dados:
|
|
|
<pre>
|
|
|
```bash
|
|
|
db.url=jdbc:postgresql://localhost:5432/[NOME_BD]
|
|
|
db.username=[USUARIO_BD]
|
|
|
db.password=[SENHA_USUARIO_BD]
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
### 5. Compilação e Instalação do sistema
|
|
|
|
|
|
1. Antes da primeira execução do sistema, execute o seguinte comando para limpar arquivos temporários antigos e evitar erros:
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ mvn clean
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
2. Compilar o sistema, executando o comando a seguir na raiz do codigo-fonte do projeto:
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ mvn package
|
|
|
</pre>
|
|
|
|
|
|
```
|
|
|
|
|
|
3. Instalar o sistema, executando os comandos a seguir. Durante essa instalação serão criadas as tabelas no banco de dados configurado e o diretório configurado no arquivo build.properties contendo todos os arquivos necessários para a execução do Dspace.
|
|
|
```bash
|
|
|
$ cd <DIR_SRC>/dspace/targer/dspace-
|
|
|
$ ant fresh_install
|
|
|
|
|
|
```
|
|
|
|
|
|
4. Configurando o tomcat7 para executar os webapps do sistema
|
|
|
|
|
|
* Opcao 1) Copiar os arquivos compilados para o diretório de webapps do tomcat7:
|
|
|
```bash
|
|
|
$ sudo cp <DIR_SRC>/target/*.war /var/lib/tomcat7/webapps/
|
|
|
```
|
|
|
|
|
|
* Opcao 2) Configurar o tomcat7 para acessar os webapps diretamente do diretório de instalação do DSpace:
|
|
|
|
|
|
Reiniciar o tomcat7 para que os novos webapps sejam executados:
|
|
|
```bash
|
|
|
$ sudo service tomcat7 restart
|
|
|
|
|
|
```
|
|
|
|
|
|
### Testando o sistema
|
|
|
|
... | ... | @@ -81,33 +83,28 @@ http://localhost:8080/<NOME_WEBAPP> |
|
|
### Extras
|
|
|
|
|
|
* Configuração das variáveis de ambiente
|
|
|
|
|
|
Adicione ao arquivo /usr/share/tomcat7/bin/setenv.sh as seguintes linhas:
|
|
|
<pre>
|
|
|
```bash
|
|
|
#!/bin/bash
|
|
|
export CATALINA_OPTS="$CATALINA_OPTS -Xms512m -Xmx2g"
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
* Configurar o tomcat para usar criptografia SSL/HTTPS
|
|
|
|
|
|
1. Criar uma chave RSA
|
|
|
<pre>
|
|
|
```bash
|
|
|
$ keytool -genkey -alias tomcat -keyalg RSA -keystore <CAMINHO_CHAVE>
|
|
|
</pre>
|
|
|
|
|
|
```
|
|
|
|
|
|
2. Configurar o tomcat para usar a chave para criptografar os dados
|
|
|
|
|
|
3. Adicionar o código a seguir dentro da tag “Service” no arquivo “/var/lib/tomcat7/conf/server.xml”:
|
|
|
<pre>
|
|
|
```xml
|
|
|
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="[ARQUIVO_KEYSTORE]" keystorePass="[SENHA]" />
|
|
|
</pre>
|
|
|
```
|
|
|
|
|
|
4. Configurar o usuário para acessar o tomcat7-admin via web
|
|
|
|
|
|
5. Adicionar a linha a seguir dentro da tag “tomcat-users” no arquivo “/var/lib/tomcat7/conf/tomcat-users.xml”:
|
|
|
<pre>
|
|
|
```xml
|
|
|
<user username="admin" password="admin" roles="manager-gui,manager-script,manager-jmx,manager-status,tomcat"/>
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
``` |
|
|
\ No newline at end of file |