Manual de Instalao

Cd. Manual de Instalacao_NG

Ultima atualizao: 08/09/2014 10:55
Protegido pela Lei de Direito Autoral n 9610/98




08/09/14
2


Contedo
Apresentao 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
08/09/14
3
Falha na importao das telas do Cronos ............................... Error! Bookmark not defined.
Falha na execuo dos servios ........................................................................................... 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.



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.


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


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:



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 a
C:\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 Inicial Painel de Controle
Ferramentas Administrativas Servios
c. Localize os trs servios Lyceum.

08/09/14
9

d. Pare os trs servios



e. Feche a 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 <Enter> 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.

08/09/14
10

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




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 Inicial Painel 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).

1
A instalao da Plataforma Java no requer configuraes especficas, basta executar o setup.
08/09/14
12
o JRE_HOME: adicione a varivel JRE_HOME que corresponde ao
diretrio da Mquina Virtual Java JRE (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 na
varivel 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 PATH so separados por ";" sendo que o ltimo caminho
no existe nenhuma pontuao.
Ex.: C:\Program Files (x86)\Microsoft SQL Server\100\Tools\Binn\;C:\Program
Files\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
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"


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 criado
iii. Inicie o servio Lyceum
iv. Abrir o navegador no endereo http://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.


<Connector acceptCount="100" connectionTimeout="20000"
disableUploadTimeout="true" enableLookups="false"
maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150"
minSpareThreads="25" port="8080" redirectPort="8443"/>

A porta normalmente usada 80.


<Connector acceptCount="100" connectionTimeout="20000"
disableUploadTimeout="true" enableLookups="false"
maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150"
minSpareThreads="25" port="80" redirectPort="8443"/>

A5. PASSO 5: REMOO DAS APLICAES PADRO (OPCIONAL)
Ao final deste procedimento voc tem um servidor Tomcat instalado e funcionando. O
Tomcat 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.



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 e
Secretaria.war. Voc pode instalar somente uma delas, ou todas. Siga os passos
abaixo.
a. Abra o Gerenciador de Servios: Menu Inicial Painel de Controle
Ferramentas Administrativas Servios, e pare o servio Lyceum.
b. Copie o arquivo jaas.config para a pasta C:\Program
Files\Lyceum\conf
c. Crie a pasta C:\Program Files\Lyceum\conf\Catalina\localhost
08/09/14
16
d. Para instalar o Aluno Online, copie o arquivo AOnline.war para a pasta
C:\Program Files\Lyceum\webapps, e o arquivo AOnline.xml para a
pasta C:\Program Files\Lyceum\conf\Catalina\localhost
e. Para instalar o Docente Online, copie o arquivo DOnline.war para a
pasta C:\Program Files\Lyceum\webapps, e o arquivo DOnline.xml
para a pasta C:\Program Files\Lyceum\conf\Catalina\localhost
f. Para instalar a Secretaria, copie o arquivo Secretaria.war para a pasta
C:\Program Files\Lyceum\webapps, e o arquivo Secretaria.xml para 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 tags do 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:


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:
a. Abra o Gerenciador de Servios: Menu Inicial Painel de Controle
Ferramentas Administrativas Servios, e pare o 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



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.



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 Dados Disponveis.
f. Selecionar o banco do Lyceum e Hades.
g. Clique em Instalar/Atualizar
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:




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.
a. Abra o Gerenciador de Servios: Menu Inicial Painel de Controle
Ferramentas Administrativas Servios, e inicie o 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.



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 SSL NO 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).


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 para Yes.

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.


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
<diretrio de instalao>\log.
Abrir o diretrio C:\Program Files\Lyceum\ logs e verificar os arquivos:
catalina.YYYY-MM-DD.log
service-stderr. YYYY-MM-DD.log


capacitacao@techne.com.br