Manual de Instalacao NG

5/20/2018 Manual de Instalacao NG

1/24

Manual de Instalao

Cd.Manual de Instalacao_NG

Ultima atualizao:08/09/2014 10:55

Protegido pela Lei de Direito Autoral n 9610/98


2/24

08/09/14

2

ContedoApresentao e Objetivos ......................................................................................... 4

Requisitos para instalao ........................................................................................ 5

Atualizao do Banco de Dados do Lyceum ............................................................... 6

Remoo de verses anteriores do Lyceum ............................................................... 8

A1. Salvando os arquivos customizados ............................................................ 8

A2. Remoo da verso antiga .......................................................................... 8

Sugesto de Instalao do Servidor Apache Tomcat ................................................ 11

A1. Passo 1: instalao do JDK......................................................................... 11

A2. Passo 2: Definio das Variveis de Ambiente ........................................... 11

A3. Passo 3: Instalao do Tomcat................................................................... 12

A4. Passo 4: Configurao da Porta do Tomcat (Opcional) ............................... 14

A5. Passo 5: Remoo das aplicaes padro (Opcional) .................................. 14

Instalao dos mdulos do Lyceum ......................................................................... 15

A1. Obteno dos Arquivos de Instalao ........................................................ 15

A2. Instalao das aplicaes .......................................................................... 15

A3. Configurao de Memria do Servidor e de Autenticao JAAS ................. 17

Importao das Telas do Lyceum ............................................................................ 19

Configurao SSL (Opcional) ................................................................................... 22

A1. Obter um certificado digital. ..................................................................... 22

A2. Configurar o uso de SSL no Tomcat ............................................................ 22

Problemas durante a instalao .............................................................................. 23


3/24

08/09/14

3

Falha na importao das telas do Cronos ...............................Error! Bookmark not defined.

Falha na execuo dos servios ........................................................................................... 24


4/24

08/09/14

4

APRESENTAO E OBJETIVOS

A nova verso do Lyceum baseada na plataforma Java, e sua interface com os

usurios feita atravs de navegadores web e aplicativos mveis. O Lyceum deve ser

instalado em um servidor no qual haja uma mquina virtual Java e um Apache Tomcat

previamente instalados.

Esse manual tem como objetivo servir como referncia para instalao dos mdulos

do Lyceum. Inclui dicas de como instalar o Java e o Tomcat em um servidor Windows, e

apresenta o procedimento de instalao dos mdulos do Lyceum neste servidor.

O documento dividido em sete partes:

1) Requisitos mnimos de hardware e software.

2) Remoo de verses anteriores do Lyceum (v6.0 a v6.1.03)

3) Dicas para instalao de um servidor Apache Tomcat.

4) Guia de atualizao dos bancos de dados do Lyceum

5) Guia de instalao dos mdulos do Lyceum.

6) Como configurar as portas de cada mdulo e os bancos de dados das aplicaes

caso seja necessrio (passo opcional).

7) Dicas para soluo de problemas de instalao e configurao.


5/24

08/09/14

5

REQUISITOS PARA INSTALAO

A mquina onde ser instalado o servidor da aplicao do Lyceum deve atender aos

seguintes requisitos de hardware e software.

Requisitos Mnimos de Hardware

Processador: Core 2 Duo x64 de 2GHz ou superior.

Memria: mnimo de 8GB, recomenda-se 16GB

Espao em disco: mnimo de 500 MB (para a instalao completa dos mdulos

Aluno Online, Docente Online e Secretaria/Relacionamento).

Requisitos de Software

Sistema Operacional em 64 bits: Windows 2008, Windows Vista ou Windows 7.

Plataforma Java: (Java Runtime Engine - JRE) na verso 1.6 ou superior, em 64

bits.

Servidor da Aplicao:Apache Tomcat verso 7.0 ou superior.

Alm disso, preciso que haja um banco de dados do Lyceum j instalado em

algum servidor SQL Server, e que este servidor esteja acessvel na rede.

Banco de Dados: SQL Server 2005 ou superior, com os bancos de dados

Lyceum e Hades.


6/24

08/09/14

6

ATUALIZAO DO BANCO DE DADOS DO LYCEUM

Para atualizar a verso do banco do Lyceum e Hades para verso 6.1.04 necessrio

executar os scripts de atualizao, seguindo os passos a seguir:

a. Obtenha o arquivo dos scripts de atualizao, identificado como

SP_6104_ScriptsAtualizacao.zip.

b. Extraia o contedo deste arquivo para a pasta C:\ScriptsAtualizacao

c. Execute o programa SetupBD.exe, contido nesta pasta. Execute o programa como

Administrador.

d. Escolha o tipo de servidor que contm o banco de dados do Lyceum:

e. Fornea o nome do servidor de banco de dados, login e senha (figura abaixo).

f. Clique em Listar Bancos de Dados Disponveis.

g. Selecionar os bancos de dados do Lyceum e Hades.

h. Clique em Instalar/Atualizar


7/24

08/09/14

7

i. Ser aberta uma janela de prompt de comando por onde sero executados os

scripts de atualizao. Este procedimento pode levar vrios minutos dependendo

do tamanho dos bancos de dados e da velocidade de acesso. Aguarde. No feche

as janelas.

j.

Ao final da atualizao ser exibida a mensagem abaixo:


8/24

08/09/14

8

REMOO DE VERSES ANTERIORES DO LYCEUM

ESTE CAPTULO SE APLICA APENAS AOS AMBIENTES QUE J POSSUEM INSTALADA, UMA VERSO

JAVA DO LYCEUM, ANTERIOR A 6.1.04.

CASO A VERSO ATUALMENTE INSTALADA SEJA A 6.1.04 OU SUPERIOR, PULE PARA O PRXIMO

CAPTULO.

A1. SALVANDO OS ARQUIVOS CUSTOMIZADOS

a. Localize a pasta onde est instalada a verso atual do Lyceum java. Ex.:

C:\Program Files\LyceumNG.

b. Crie uma pasta para guardar uma cpia de todos os arquivos customizados. Ex.:

C:\LyceumCust

c.

Copie os seguintes arquivos para a pasta recm criada, no nosso exemplo aC:\LyceumCust:

C:\Program Files\LyceumNG\AOnline\webapps\ROOT\app\AOnline\style\aonline.css

C:\Program Files\LyceumNG\AOnline\webapps\ROOT\app\AOnline\script\aonline.js

C:\Program Files\LyceumNG\DOnline\webapps\ROOT\app\DOnline\style\donline.css

C:\Program Files\LyceumNG\DOnline\webapps\ROOT\app\DOnline\script\donline.js

C:\Program Files\LyceumNG\Secretaria\webapps\ROOT\app\Secretaria\style\c_lyceum.css

C:\Program Files\LyceumNG\Secretaria\webapps\ROOT\app\Secretaria\script\secretaria.js

A2. REMOO DA VERSO ANTIGA

a. Localize a pasta onde est instalada a verso atual do Lyceum java. Ex.:

C:\Program Files\LyceumNG.

b. Abra o Gerenciador de Servios: Menu InicialPainel de Controle

Ferramentas AdministrativasServios

c. Localize os trs servios Lyceum.


9/24

08/09/14

9

d. Pare os trs servios

e. Fechea janela do Gerenciador de Servios.

f. Execute o arquivo C:\Program Files\LyceumNG\DesinstaladorLyceum.bat, como

Administador.

g. No prompt de comando digite S e confirme com para a remoo dos

trs servios das aplicaes Lyceum.

h. Aps a remoo dos servios a janela do prompt fechar e ser aberta outra

janela para remoo dos arquivos das aplicaes. Marque a opo Forar a

remoo de C:\Program Files\LyceumNG e clique no boto Desinstalar.

i.


10/24

08/09/14

10

j. A remoo s ter terminado quando a *Terminado+for exibida:


11/24

08/09/14

11

SUGESTO DE INSTALAO DO SERVIDOR APACHE TOMCAT

Os mdulos do Lyceum foram projetados para rodarem como aplicaes dentro de

servidores web Java, e o Tomcat o servidor recomendado. O Tomcat um servidor web de

cdigo aberto, mantido pela Fundao Apache. Pode ser copiado do site

http://tomcat.apache.org/ .

Este captulo apresenta um roteiro bsico como sugesto para a instalao do Tomcat.

Ao final desse roteiro voc ter uma instalao padro do Tomcat, com o mnimo necessrio

para rodar as aplicaes do Lyceum em java.

Recomendamos fortemente que as configuraes desse servidor sejam revisadas para

atenderem s polticas de segurana de rede da sua instituio.

Se voc j tiver conhecimentos sobre a instalao do Tomcat, pode pular este captulo.

A1. PASSO 1:INSTALAO DO JDK

Antes de instalar o Tomcat, preciso instalar um JDK (Java Development Kit) na verso

1.6 ou superior, em 64 bits.

A verso mais recente do JDK pode ser obtida gratuitamente do site da Oracle, no

endereo (http://www.java.com/pt_BR/download/manual.jsp)1. O processo de instalao

simples, bastando seguir as instrues do assistente de instalao.

Importante: ao instalar, certifique-se de que a verso escolhida do JDK de 64 bits.

A2.

PASSO 2:DEFINIO DAS VARIVEIS DE AMBIENTE

Depois de instalar o JDK, preciso definir as variveis de ambiente usadas pelo

Tomcat. No Windows, siga os passos:

a. Abra o painel de controle: Menu InicialPainel de Controle

b. Selecione o cone Sistema

c. Clique no link Configuraes Avanadas

d. Selecione a aba Avanado, e o boto Variveis de Ambiente

e. Na lista de Variveis de Sistema, clique no boto Novo

f. Adicione as variveis JAVA_HOME, JRE_HOME e edite a varivel PATH.

o JAVA_HOME:adicione a varivel JAVA_HOME que corresponde ao

diretrio base da Plataforma JDK. (Ex.: C:\Program

Files\Java\jdk1.6.0_17).

1A instalao da Plataforma Java no requer configuraes especficas, basta executar o setup.
http://tomcat.apache.org/http://tomcat.apache.org/http://tomcat.apache.org/


12/24

08/09/14

12

o JRE_HOME:adicione a varivel JRE_HOME que corresponde ao

diretrio da Mquina Virtual JavaJRE (Ex.: C:\Program

Files\Java\jdk1.6.0_17\jre).

o PATH:Edite a varivel PATH que aponta para o diretrio bin do SDK (Ex.:

C:\Program Files\Java\jdk1.6.0_17\bin). O valor acrescentado navarivel PATH deve ser precedido de ; (ponto e vrgula).

No exemplo abaixo, a pasta do JDK C:\Program Files\Java\jdk1.6_17.

Observao:Os caminhos de PATHso separados por ";" sendo que o ltimo caminhono existe nenhuma pontuao.

Ex.: C:\Program Files (x86)\Microsoft SQL Server\100\Tools\Binn\;C:\ProgramFiles\Java\ jdk1.6.0_17\jre\bin\

A3.

PASSO 3:INSTALAO DO TOMCAT

A verso mais recente do Tomcat 7 pode ser encontrada no site

http://tomcat.apache.org/download-70.cgi . A seo Binary Distributions oferece vrios

pacotes para instalao. Escolha a distribuio 64-bit Windows zip.Ser copiado um arquivo

zip com nome semelhante a apache-tomcat-7.0.xx-windows-x64.zip
http://tomcat.apache.org/download-70.cgihttp://tomcat.apache.org/download-70.cgihttp://tomcat.apache.org/download-70.cgi


13/24

08/09/14

13

Crie a pasta C:\Program Files\Lyceum\(ou C:\Arquivos de Programa\Lyceum, se o

Windows estiver em portugus). Extraia o contedo do arquivo zip para dentro desta pasta. Ao

final, a estrutura de diretrios deve ser semelhante a esta:

Com os arquivo copiados, falta criar um servio Windows para o Apache. Neste

exemplo, o servio ser criado com o nome Lyceum.

a. Abra o Command Prompt como Administrador

b. Execute os comandos abaixo:

cd C:\Program Files\Lyceum\bin

service install Lyceum

tomcat7 //US//Lyceum -DisplayName="Lyceum"

tomcat7 //US//Lyceum -Description="Servidor Apache Tomcat - Lyceum"


14/24

08/09/14

14

c. Verifique se o servio foi instalado corretamente.

i. Abra o gerenciador de servios

%windir%\system32\services.msc

ii.

Verifique se o servio Lyceum foi criadoiii. Inicie o servio Lyceum

iv. Abrir o navegador no endereohttp://localhost:8080/

v. O navegador deve mostrar a tela inicial do Tomcat

A4. PASSO 4:CONFIGURAO DA PORTA DO TOMCAT (OPCIONAL)

Por padro o Apache Tomcat acessado pela porta 8080, no entanto essa porta pode

ser configurada editando-se o arquivo C:\Program Files\Lyceum\conf\server.xml.

Basta alterar a tag Connector, trocando o valor default 8080 pelo que for mais

adequado sua instituio. A porta normalmente usada 80.

A porta normalmente usada 80.

A5.

PASSO 5:REMOO DAS APLICAES PADRO (OPCIONAL)

Ao final deste procedimento voc tem um servidor Tomcat instalado e funcionando. OTomcat vem com algumas aplicaes de demonstrao e configurao previamente instaladas.

Recomenda-se que elas sejam removidas.

Para isso, apague todo o contedo do diretrio C:\Program Files\Lyceum\webapps,

sem remover o prprio diretrio.
http://localhost:8080/http://localhost:8080/http://localhost:8080/http://localhost:8080/


15/24

08/09/14

15

INSTALAO DOS MDULOS DO LYCEUM

A1.

OBTENO DOS ARQUIVOS DE INSTALAO

Os mdulos web do Lyceum so disponibilizado um arquivo ZIP. Exemplo:

SP_6104_SetupAtualizacaoNG.zip

Descompacte o arquivo em um diretrio temporrio (sugesto: c:\temp).

Os arquivos que fazem parte do pacote de instalao so os seguintes:

Arquivo Descrio

AOnline.war Aplicao Web do Aluno Online

DOnline.war Aplicao Web do Docente Online

Secretaria.war Aplicao Web de Secretaria

TelasLyceum.zip Utilitrio de importao de telas das aplicaes

config\AOnline.xml Arquivo de configurao do Aluno Online

config\DOnline.xml Arquivo de configurao do Docente Online

config\Secretaria.xml Arquivo de configurao da Secretaria

config\jaas.config Arquivo de configurao do JAAS.

A2. INSTALAO DAS APLICAES

Para instalar as aplicaes, basta copiar os arquivos para os diretrios

apropriados do Tomcat. H trs arquivos de aplicaes: AOnline.war, DOnline.war eSecretaria.war. Voc pode instalar somente uma delas, ou todas. Siga os passos

abaixo.

a. Abra o Gerenciador de Servios: Menu InicialPainel de Controle

Ferramentas AdministrativasServios, e pareo servio Lyceum.

b. Copie o arquivojaas.configpara a pasta C:\Program

Files\Lyceum\conf

c. Crie a pasta C:\Program Files\Lyceum\conf\Catalina\localhost


16/24

08/09/14

16

d. Para instalar o Aluno Online, copie o arquivo AOnline.warpara a pasta

C:\Program Files\Lyceum\webapps, e o arquivo AOnline.xmlpara a

pasta C:\Program Files\Lyceum\conf\Catalina\localhost

e. Para instalar o Docente Online, copie o arquivo DOnline.warpara a

pasta C:\Program Files\Lyceum\webapps, e o arquivo DOnline.xmlpara a pasta C:\Program Files\Lyceum\conf\Catalina\localhost

f. Para instalar a Secretaria, copie o arquivo Secretaria.warpara a pasta

C:\Program Files\Lyceum\webapps, e o arquivo Secretaria.xmlpara a

pasta C:\Program Files\Lyceum\conf\Catalina\localhost

g. Abra o arquivo C:\Program

Files\Lyceum\conf\Catalina\localhost\AOnline.xml

h. Edite as conexes com o banco de dados (contidas nos tagsdo tipo

Resource), substituindo os marcadores abaixo pelas informaes de

conexo com o banco correspondentes.

${BancoDeDadosServer} Servidor onde est o banco de dados do

Lyceum

${BancoDeDadosBDHades} Banco de dados do Hades

${BancoDeDadosBDLyceum} Banco de dados do Lyceum

${BancoDeDadosUsuario} Usurio do banco de dados

${BancoDeDadosSenha} Senha do usurio do banco de dados

${UsuarioCronosSenha} Senha do usurio cronos

Exemplo:


17/24

08/09/14

17

i. Repetir o procedimento descrito acima para os arquivos DOnline.xml e

Secretaria.xml, tambm localizados na pasta C:\Program

Files\Lyceum\conf\Catalina\localhost.

A3. CONFIGURAO DE MEMRIA DO SERVIDOR E DE AUTENTICAO JAAS

O Lyceum exige mais memria RAM do que o Tomcat est preparado para

usar na sua configurao padro. Alm disso, o Lyceum usa o padro JAAS para

autenticao dos usurios. Por isso, preciso alterar as configuraes do servidor para

aumentar o limite de memria e ajustar a autenticao.

Para alterar esses configuraes, siga esses passos:


Ferramentas AdministrativasServios, e pareo servio Lyceum.

b. Execute o Prompt de Comando como Administrador(Run as

Administrator)

c. Execute os comandos abaixo

cd C:\Program Files\Lyceum\bin

tomcat7w //ES/Lyceum

d. Ser aberta a tela de configurao do Tomcat (figura abaixo). Clique na

aba Java

e.

Preencha o campo Initial memory pool com o valor 512.

f. Preencha o campo Maximum memory pool com o valor 4096.

g. No campo Java Options, adicione as seguintes linhas:-Djava.security.auth.login.config=C:\Program

Files\Lyceum\conf\jaas.config

-Xms512m

-Xmx4096m

-XX:MaxPermSize=384m


18/24

08/09/14

18

h. Selecione a aba General.

i. Altere o valor do campo Startup type para Manual

j. Clique OK para salvar as alteraes.


19/24

08/09/14

19

IMPORTAO DAS TELAS DO LYCEUM

A ltima tarefa da instalao a importao das telas. As telas so

armazenadas na forma de registros no banco de dados do Lyceum. Para que elas

fiquem disponveis para os usurios, preciso executar o aplicativo de importao de

telas, que faz a carga no banco de dados.

A1. IMPORTADOR DE TELAS

Para importar as telas das aplicaes Lyceum necessrio executar o Importador de

Telas (TelasLyceum.exe), seguindo os passos a seguir:

a. Decompacte o arquivo C:\temp\TelasLyceum.zip

b. Execute o TelasLyceum.exe seguindo os prximos passos.

c. Fornea o nome do servidor de banco de dados, login e senha como mostra a

figura abaixo.

d. Caso a senha do usurio cronos no seja mais a senha padro, informe a nova no

campo Senha do cronos.

e. Clique em Listar Bancos de DadosDisponveis.

f. Selecionar o banco do Lyceum e Hades.

g. Clique em Instalar/Atualizar


20/24

08/09/14

20

h. Sero abertas duas janelas de prompt de comando: a primeira ir executar uma

exportao das telas da verso atualmente instalada (cpia de segurana), caso

exista uma verso anterior instalada, e em seguida a segunda ir importar as novas

telas. Este procedimento pode levar vrios minutos dependendo do nmero de

telas customizadas e da velocidade de acesso.

i. Ao final da importao ser exibida a mensagem abaixo:


21/24

08/09/14

21

A2. INICIALIZAO DO SERVIDOR

Ao final da importao das telas, o Lyceum est pronto para ser executado.

Basta iniciar o servio Windows do Lyceum.


Ferramentas AdministrativasServios, e inicieo servio

Lyceum.

b. Abra um browser

c. Entre nos endereos abaixo para testar as aplicaes.

http:\\localhost:8080\AOnline Aluno Online

http:\\localhost:8080\DOnline Docente Online

http:\\localhost:8080\Secretaria Secretaria

Obs: Se voc mudou a porta do Tomcat para 80, os endereos

passam a ser estes.

http:\\localhost\AOnline Aluno Online

http:\\localhost\DOnline Docente Online

http:\\localhost\Secretaria Secretaria

a. Ao incio de cada aplicao, apresentada a tela de login. Digite um

usurio e senha vlidos e selecione Entrar.

b.

Pronto. O Lyceum est em funcionamento.


22/24

08/09/14

22

CONFIGURAO SSL(OPCIONAL)

Por razes de segurana, recomenda-se o uso de SSL para criptografar o trfego de

dados entre os navegadores dos usurios e o servidor Tomcat. Para isso, preciso:

A1. OBTER UM CERTIFICADO DIGITAL.

H vrias empresas de segurana que vendem certificados digitais para SSL. Os preos

variam de acordo com o nvel de segurana oferecido. Escolha a empresa e a certificao que

melhor se adequem politica da sua instituio.

A2.

CONFIGURAR O USO DE SSLNO TOMCAT

O procedimento relativamente simples, e pode ser obtido na pgina de

documentao do Tomcat 7 (http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html ).
http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.htmlhttp://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.htmlhttp://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.htmlhttp://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html


23/24

08/09/14

23

PROBLEMAS DURANTE A INSTALAO

A1.

FALHA NA IMPORTAO DAS TELAS DO LYCEUM

Antes de tentar realizar a importao das telas novamente verifique:

Se o protocolo TCP-IP est habilitado no SQL Server: no grupo de programas do

SQL Server acesse a ferramenta SQL Server Configuration Manager

Caso o protocolo TCP-IP no esteja habilitado clique duas vezes nele e altere a

propriedade Enabled paraYes.

Conexo com o bancos de dados do Hades : atravs do console do SQL server

tente se conectar ao servidor onde se localiza o banco Hades, utilizando o

usurio = cronos e senha = cronos.


24/24

08/09/14

24

A2. FALHA NA EXECUO DOS SERVIOS

A execuo dos servio pode falhar por diversos motivos. Para investigar as

possveis causas aconselhvel utilizar o log do tomcat localizado no diretrio

\log.

Abrir o diretrio C:\Program Files\Lyceum\ logs e verificar os arquivos:

catalina.YYYY-MM-DD.log

service-stderr. YYYY-MM-DD.log

[email protected]
mailto:[email protected]:[email protected]:[email protected]

Date post:	10-Oct-2015
Category:	Documents
Upload:	heliomar-junior
View:	41 times
Download:	0 times

Manual de Instalacao NG

Documents