GUIA DE CONFIGURAÇÃO DO AMBIENTE GGAS

Transcrição

1 GUIA DE CONFIGURAÇÃO DO AMBIENTE GGAS Guia de Configuração 1

2 Histórico de Alterações Data 18/05/ /06/ /06/2016 Versão Descrição Criação do documento. Atualização das seções 2, 9 e 10 Revisão do documento Autor Arthur Carvalho Arthur Carvalho Roberto Alencar 2

3 Índice 1Introdução...4 2Ferramentas Utilizadas no Ambiente Pré-requisitos de Hardware...4 3Instalação de Banco de Dados Ambiente Windows Ambiente Linux...7 4Instalação de JDK Instalando o JDK 1.7 em Windows Instalando o JDK 1.7 em Linux RedHat, CentOs ou Fedora Instalando o JDK 1.7 em Ubuntu Verificando a instalação Instalando SQLDeveloper Instalação de Gradle Instalando IDE Eclipse Instalando APACHE TOMCAT Executando o Projeto GGAS Obtendo o projeto do Repositório Git com Eclipse Egit; Abrindo o projeto via Gradle Criando Usuários do Banco de Dados Executando o Projeto Servidor Jetty em Ambiente de Produção Instalação do Jetty Inicialização do Jetty

4 1 Introdução Esse documento tem como objetivo ser um guia prático para preparação do ambiente deo Projeto GGAS. 2 Ferramentas Utilizadas no Ambiente Para a preparação do ambiente de Desenvolvimento do projeto GGAS será necessário a instalação das seguintes ferramentas: Oracle 11xe: technologies/express edition/downloads/index.html JDK 7: downloads html SqlDeveloper: tools/sql developer/downloads/index.html Gradle 2.2.1: bin.zip Eclipse: TomCat_7.0: 7/v7.0.69/bin/apache tomcat zip Jetty 9: distribution/ v /jetty distribution v zip Nas seções posteriores será detalhado o processo de instalação de cada um das ferramentas listadas. 2.1 Pré-requisitos de Hardware Requisitos Mínimos de Hardware: Memória: 4GB RAM; 3 Processador: 2 núcleos; Disco (livre): 60 GB. Instalação de Banco de Dados Atualmente o projeto GGAS pode ser executado em ambientes Windows e Linux utilizando Banco de Dados Oracle versão 11g. Para tal instalação é necessário seguir os passos abaixo: 4

5 Baixar o instalador do Oracle edition/downloads/index.html É necessário criar uma conta no site da Oracle para isso e aceitar os termos de licença. 3.1 Ambiente Windows Descompactar o arquivo Zip e executar o arquivo Setup.exe: Ler e aceitar os termos de licença; Selecionar o local da instalação do Oracle: 5

6 Informar uma senha para os usuários SYS e SYSTEM do banco de dados (estes são os usuários administradores do banco de dados e você precisará se lembrar dessa senha depois). 6

7 Ao final, é apresentada uma tela de resumo da instalação, e ao clicar em Instalar o instalador dará seguimento a instalação até a sua conclusão: 3.2 Ambiente Linux A Oracle fornece instalador para ambiente Linux em formato RPM por tanto esse instalador é compatível apenas com distribuições RedHat ou distribuições baseadas nesta tais como CentOs e Fedora. É possível instalar o Oracle em distribuições derivadas do Debian e Ubuntu porém para isto é necessário converter o instalador RPM para o formato DEB utilizando software de terceiros. Pré-requisitos: É necessário realizar a instalação de algumas dependências que pode ser feita através do comando: yum install libaio bc flex Executando a Instalação: Feito o download do arquivo oracle-xe x86_64.rpm.zip é necessário extrair o arquivo: unzip q oracle xe x86_64.rpm.zip 7

8 O arquivo RPM será extraído dentro da pasta Disk1 e o mesmo deverá ser executado pelos comandos: cd Disk1 rpm ivh oracle xe x86_64.rpm Após a execução, será exibido no console a saída abaixo: [root@ms3 Disk1]# rpm ivh oracle xe x86_64.rpm Preparing... 1:oracle xe ########################################### [100%] ########################################### [100%] Executing post install steps... You must run '/etc/init.d/oracle xe configure' as the root user to configure the database. [root@ms3 Disk1]# Configurando o Oracle Neste ponto da instalação o SGDB já está instalado porém não está configurado. É necessário configurar as portas e senha dos usuários administradores SYS e SYSTEM. Esta configuração será feita através do comando abaixo. /etc/init.d/oracle xe configure Uma vez configurado, devemos configurar as variáveis de Ambiente. Podemos configurar as variáveis através do script abaixo: /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh 4 Instalação de JDK7 O Projeto GGAS em sua versão atual é compatível com o Java Development Kit 1.7 O instalador do JDK 7 está disponível através do link: 8

9 downloads html 4.1 Instalando o JDK 1.7 em Windows Deve-se executar o instalador Windows Após a execução do instalador, é necessário configurar a variável de ambiente JAVA_HOME com o caminho da pasta onde o JDK foi instalado através do Painel de Controle. 9

10 Deve-se clicar em Opções avançadas e em variáveis de ambiente nós devemos adicionar a variável JAVA_HOME. 10

11 4.2 Instalando o JDK 1.7 em Linux RedHat, CentOs ou Fedora Podemos instalar o JDK7 nas distribuições citadas acima através da sequência de comandos. Obtendo o instalador via console: wget no cookies no check certificate header "Cookie: gpw_e24=http%3a%2f%2fwww.oracle.com%2f; oraclelicense=accept securebackup cookie" " b15/jdk 7u79 linux x64.rpm" yum localinstall jdk 7u79 linux x64.rpm O usuário também pode fazer a o download via browser utilizando o link disponibilizado na seção e executar a instalação manualmente através do comando: dpkg i jdk 7u79 linux x64.rpm 4.3 Instalando o JDK 1.7 em Ubuntu Podemos instalar o JDK7 nas distribuição Ubuntu através da sequência de comandos: sudo apt get install python software properties sudo add apt repository ppa:webupd8team/java sudo apt get update sudo apt get install oracle java7 installer Verificando a instalação Após a instalação do JDK devemos podemos verificar se o mesmo esta funcionando corretamente pelo comando: java version A saída do comando deve ser: java version "1.7.0_79" 11

12 Java(TM) SE Runtime Environment (build 1.7.0_79 b15) Java HotSpot(TM) 64 Bit Server VM (build b11, mixed mode) 5 Instalando SQLDeveloper O SqlDeveloper é uma IDE para administração do SGDB Oracle fornecida gratuitamente pelo fabricante. Esta IDE tem como pré-requisito que uma máquina virtual Java tenha sido instalada. Podemos obter o instalador do SQLDeveloper através do link: Após a instalação do SqlDeveloper, devemos fazer um teste de Conexão utilizando o usuário SYSTEM e senha definida na seção 2. 12

13 6 Instalação de Gradle A versão atual do projeto GGAS utiliza o Framework Gradle. Este possui a responsabilidade de gerenciar as dependências do projeto e configurar a montagem dos pacotes possibilitando que seja utilizado qualquer IDE para desenvolvimento. A versão utilizada no projeto é a versão que está disponível em Após o download e extração do arquivo ZIP é necessário atualizar a variável de ambiente PATH com o caminho da instalação gradle 2.2.1/bin 7 Instalando IDE Eclipse Apesar de ser possível contribuir para o Projeto GGAS utilizando a IDE de sua preferência, mostraremos o passo a passo para a configuração do Projeto GGAS utilizando a IDE Eclipse. Devemos utilizar a versão Eclipse IDE for Java EE Developers disponível em Após o download, devemos extrair o arquivo e executar o arquivo eclipse ; 13

14 Após abrir a IDE devemos acessar o MarketPlace pelo menu >> Hekp >> Eclipse MarketPlace para que possamos adquirir os plugins Gradle IDE Pack e EGit; 14

15 Devemos configurar o nosso workspace para que o eclipse utilize o Gradle instalado na seção 4. Devemos colocar em Gradle Distribuition a pasta onde configuramos o Gradle. Obs.: A configuração do workspace está disponível pelo menu Window >> Preferences. 15

16 Devemos configurar o JDK quanto a utilização de memória adicionando os argumentos: Xmx1024m XX:MaxPermSize=512m Dnet.sf.ehcache.skipUpdateCheck=true 8 Instalando APACHE TOMCAT 7 O servidor Apache Tomcat é uma implementação de referência das tecnologias JSP e Servlets e é utilizado no projeto GGAS desde a concepção do projeto. Este servidor pode ser utilizado em ambiente de desenvolvimento porém em ambiente de produção recomendamos a utilização do servidor Jetty por possuir melhor desempenho. A configuração em ambiente de produção será apresentada na seção 10 deste documento. Para executarmos o GGAS necessitamos de um servidor de aplicação Java e para isso podemos utilizar o TOMCAT 7.0 disponível em: 7/v7.0.69/bin/apache tomcat zip 16

17 Após o download devemos extrair o arquivo ZIP e indicar ao eclipse o local adicionando um novo servidor. Obs: A pespectiva Java EE deve está selecionada Passo 1: Passo 2: Deve-se selecionar o TOMCAT 7.0 e avançar. 17

18 Passo 3: Deve-se informar a pasta onde o TOMCAT foi extraído e finalizar a instalação do servidor. Passo 4: Deve-se aumentar o tempo de start para 200 segundos. Obs: o tempo default de start é 45s e porém o GGAS requer valores em torno de 75 segundos. Este tempo pode variar dependendo do ambiente. 18

19 Passo 5 Deve-se editar o arquivo context.xml dentro do servidor alterando a tag Context acrescentando o atributo usehttponly= false. <Context usehttponly="false"> 9 Executando o Projeto GGAS Podemos obter os fontes do projeto utilizando qualquer Cliente Git via linha de comando ou interface gráfica. Podemos utilizar o comando git clone <url repositório> para o usuários que prefiram linha de comando. Neste caso a seção 8.1 torna-se desnecessária. Obs.: Para utilizar o comando acima é necessário instalar o cliente Git Bash disponível em 10 Obtendo o projeto do Repositório Git com Eclipse Egit; Passo 1: Devemos importar um projeto do utilizando a opção abaixo: 19

20 Passo 2: Devemos clonar o repositório disponível na WEB: Passo 3: Deve-se fornecer a URL do repositório e dados para autenticação 20

21 Passo 4: Será exibido as linhas disponíveis e podemos selecionar quais linhas não devem ser copiadas localmente. (opção default todas as linhas): 21

22 Passo 5: O plugin pergunta qual linha deve ser carregada inicialmente: 11 Abrindo o projeto via Gradle Após a obtenção dos fontes, devemos importar o projeto para o nosso workspace. Passo 1: opção >> File >> Import >> Gradle Project 22

23 Passo 2: Obs.: deve-se localizar a pasta onde estão os fontes e em seguida apertar em Build Model e selecionar o projeto. 23

24 12 Criando Usuários do Banco de Dados Após a obtenção dos fontes via Git, devemos abrir via SqlDeveloper o script GGAS_SCRIPT_INICIAL_ORACLE_01_ROLES.sql contido na pasta SQL do projeto, alterar caso necessário o caminho da opção DATAFILE de acordo com o ambiente de banco de dados instalado. Após a atualização, o script deve ser executado e os usuários serão criados. Criar TableSpace Padrao create tablespace GGAS_DADOS LOGGING DATAFILE'C:\oracle\product\10.2.0\oradata\GGAS_DADOS01.DBF' size 1024m AUTOEXTEND ON NEXT 32m MAXSIZE 2048m ONLINE EXTENT MANAGEMENT LOCAL; Criar TableSpace Padrao create tablespace GGAS_INDEX LOGGING DATAFILE'C:\oracle\product\10.2.0\oradata\GGAS_INDEX01.DBF' size 1024m AUTOEXTEND ON NEXT 32m MAXSIZE 2048m ONLINE EXTENT MANAGEMENT LOCAL; 13 Executando o Projeto Passo 1: Devemos atualizar o arquivo com a configuração de banco de dados do seu ambiente. Os arquivos hibernate.properties e hibernate-test.properties deve ser atualizados. hibernate.connection.username=ggas_admin 24

25 hibernate.connection.password=ggas_admin Passo 2: Devemos Gerar as Tabelas e fornecer uma carga de dados inicial para isso devemos clicar no projeto com o botão direito selecionar a opção Run as Gradle (STS) Build e executar a task migration. Passo 3: Podemos executar o projeto no servidor clicando com o botão direito >> Run on Servier e selecionando o servidor o qual executará o GGAS. 25

26 Passo 4: Acessar a aplicação com: usuário: senha: admin admin 26

27 14 Servidor Jetty em Ambiente de Produção Jetty é um servidor HTTP e Servlet Container 100% escrito em Java. É o grande concorrente do Tomcat. A grande vantagem do Jetty com relação ao Tomcat é a sua fácil configuração. Ele também foi o pioneiro a usar I/O assíncrono para aguentar uma carga maior de usuários simultâneos sem depender da antiga estratégia thread-per-connection. É o servidor Java utilizado em grandes sites brasileiros, como o fórum do GUJ, Apple Google e outros Instalação do Jetty Para instalação do Jetty é necessário realizar o download do pacote pelo link abaixo e extraí-lo na pasta de destino. distribution/ v /jetty distribution v zip Após a extração do Jetty é necessário realizar o download do pacote pelo link abaixo e extraí-lo na pasta de destino. JAVA_OPTIONS = " server Xms1024m Xmx512m XX:+UseConcMarkSweepGC Dnet.sf.ehcache.skipUpdateCheck=true" 14.2 Inicialização do Jetty O pacote WAR que contém a aplicação deve ser copiado para pasta webapps. Após a implantação do pacote WAR o jetty pode ser inicializado pelos comandos abaixo: Windows: c:\>java %JAVA_OPTIONS% jar start.jar Linux: $ java $JAVA_OPTIONS jar start.jar ou 27

28 $ /bin/jetty.sh start 28