Sistema SGPA-IFSP. Manual de Instalação

Transcrição

1 Sistema SGPA-IFSP Manual de Instalação

2 Sumário 1. Introdução Softwares Necessários Ambiente Java Servidor MySQL Spring Tool Suit Configuração e Implantação do SGPA Executando com servidor acoplado Executando no Servidor Apache Tomcat Externo... 25

3 1. Introdução Este documento tem como objetivo apresentar o manual de instalação do Sistema Gerenciador de Projeto Acadêmicos (SGPA). Mais informações e outros manuais podem ser encontrados em

4 2. Softwares Necessários 2.1 Ambiente Java O primeiro passo para instalação do SGPA é a instalação do ambiente Java. Para isso é necessário o kit de desenvolvimento Java 8 (Java SE Development Kit 8). Faça o download da versão para o seu sistema operacional no link: downloads html

5 Após o termino do download execute o arquivo e selecione a opção Next. Selecione o local de instalação na opção Change e em selecione a opção Next.

6 Aguarde o instalador realizar a instalação.

7 Finalize a instalação selecionando a opção Close. Para testar se o Java foi instalado corretamente abra o terminal e execute o comando: java version

8 2.2 Servidor MySQL O sistema SGPA utiliza o gerenciador de banco de dados MySQL. Faça o download da versão para o seu sistema operacional no link:

9 Após o download, inicie a instalação executando o arquivo e selecionando a opção Next. Em seguida, leia, aceite os termos de licença e selecione a opção Next.

10 Selecione o tipo de instalação completa selecionando a opção Complete. Selecione a opção Install.

11 Aguarde o instalador finalizar a instalação do MySQl. Por fim, selecione a opção Lauch the MySQL Instance Configuration Wizard e selecione a opção Finish

12 Inicie o processo de configuração selecionando a opção Next. Selecione a opção Detailed Configuration e em seguida a opção Next.

13 Selecione a opção Server Machine e em seguida a opção Next. Selecione a opção Multifunctional Database e em seguida a opção Next.

14 Selecione o local da instalação e em seguida a opção Next. Selecione a opção Best Support for Multilingualism e em seguida a opção Next.

15 Selecione a opção Modify Security Setting, defina a senha para o usuário root e em seguida a opção Next. Aguarde o instalador aplicar as configurações selecionadas e iniciar o serviço.

16 Teste a instalação executando no terminal o comando: mysql user=root password=senha escolhida Crie a base de dados sgpa executando no terminal o comando: CREATE DATABASE sgpa CHARACTER SET utf8 COLLATE utf8_general_ci;

17 2.3 Spring Tool Suit Faça o download da ferramenta Spring Tool Suit no link: Após o download, descompacte os arquivos no diretório de sua preferência e execute o arquivo STS.

18 Defina o diretório onde serão salvos os projetos por meio da opção Browser e selecione a opção OK. Aguarde o Spring Tool Suit carregar.

19

20 3. Configuração e Implantação do SGPA O primeiro passo para configurar o sistema SGPA é fazer o download do projeto no link: e descompacte o projeto no diretório de sua preferência. Abra o projeto na ferramenta Spring Tool Suit acessando o menu File>Open Project From File System

21 Selecione o diretório que se encontra o projeto na opção Directory. Aguarde até que todas as dependências do Maven sejam atualizadas. Todas as configurações do sistema SGPA são definidas através do arquivo application.properties localizado no pacote src/main/resources/. Uma lista completa de todas as configurações pode ser encontrada no link:

22 Para utilizar o sistema SGPA é necessário alterar as seguintes configurações: spring.datasource.url= URL de conexão com o banco de dado spring.datasource.username= Usuário do banco de dados spring.datasource.password= Senha do usuário do banco de dados sgpa.upload.directory= Diretório onde serão armazenados os arquivos de upload. spring.mail.host= Servidor SMTP para envio de s spring.mail.username= Usuário do serviço SMTP spring.mail.password= Senha do serviço SMTP spring.mail.port= Porta do servidor SMTP 3.1 Executando com servidor acoplado Após a definição das configurações, abra o arquivo SgpaApplication.java localizado no pacote src/main/java/sgpa e selecione a opção Run as > Spring Boot App.

23 Teste a aplicação no navegador utilizando o admin@sgpa.info e senha 123. Após o primeiro acesso você deve cadastrar um novo usuário no grupo ADMIN e apagar o usuário admin@sgpa.info. Você pode também gerar um arquivo.jar que pode ser executado sem a ferramenta Spring Studio Tool. Para gerar o arquivo.jar execute o comando:

24 Após execução do comando será gerado na pasta target do projeto o arquivo sgpa

25 Você pode executar esse arquivo por meio do comando java -jar sgpa jar 3.2 Executando no Servidor Apache Tomcat Externo Para executar o sistema SGPA em um servidor apache tomcat externo é necessário gerar o arquivo.war da aplicação. Abra o arquivo pom.xml e altere o atributo packaging de jar para war.

26 Execute novamente o comando mvnw clean package Será gerado na pasta target o arquivo sgpa war

27 Copie este arquivo e cole na pasta webapps localizada no diretório de instalação do tomcat Por fim, inicie o servidor tomcat e acesse o sistema pelo navegador.