Manual de Instalacao NG
-
Upload
heliomar-junior -
Category
Documents
-
view
48 -
download
0
Transcript of 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
-
5/20/2018 Manual de Instalacao NG
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
-
5/20/2018 Manual de Instalacao NG
3/24
08/09/14
3
Falha na importao das telas do Cronos ...............................Error! Bookmark not defined.
Falha na execuo dos servios ........................................................................................... 24
-
5/20/2018 Manual de Instalacao NG
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/20/2018 Manual de Instalacao NG
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.
-
5/20/2018 Manual de Instalacao NG
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
-
5/20/2018 Manual de Instalacao NG
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:
-
5/20/2018 Manual de Instalacao NG
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.
-
5/20/2018 Manual de Instalacao NG
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.
-
5/20/2018 Manual de Instalacao NG
10/24
08/09/14
10
j. A remoo s ter terminado quando a *Terminado+for exibida:
-
5/20/2018 Manual de Instalacao NG
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/ -
5/20/2018 Manual de Instalacao NG
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 -
5/20/2018 Manual de Instalacao NG
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"
-
5/20/2018 Manual de Instalacao NG
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/ -
5/20/2018 Manual de Instalacao NG
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
-
5/20/2018 Manual de Instalacao NG
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:
-
5/20/2018 Manual de Instalacao NG
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:
a. Abra o Gerenciador de Servios: Menu InicialPainel de Controle
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
-
5/20/2018 Manual de Instalacao NG
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.
-
5/20/2018 Manual de Instalacao NG
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
-
5/20/2018 Manual de Instalacao NG
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:
-
5/20/2018 Manual de Instalacao NG
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.
a. Abra o Gerenciador de Servios: Menu InicialPainel de Controle
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.
-
5/20/2018 Manual de Instalacao NG
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 -
5/20/2018 Manual de Instalacao NG
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.
-
5/20/2018 Manual de Instalacao NG
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
mailto:[email protected]:[email protected]:[email protected]