Este manual fornece instruções para instalação de uma nova versão do sistema Lyceum, incluindo:
1) Atualização do banco de dados e remoção de versões antigas;
2) Instalação do servidor Tomcat e dos módulos do Lyceum;
3) Configuração de portas, bancos de dados e autenticação.
Este manual fornece instruções para instalação de uma nova versão do sistema Lyceum, incluindo:
1) Atualização do banco de dados e remoção de versões antigas;
2) Instalação do servidor Tomcat e dos módulos do Lyceum;
3) Configuração de portas, bancos de dados e autenticação.
Este manual fornece instruções para instalação de uma nova versão do sistema Lyceum, incluindo:
1) Atualização do banco de dados e remoção de versões antigas;
2) Instalação do servidor Tomcat e dos módulos do Lyceum;
3) Configuração de portas, bancos de dados e autenticação.
Este manual fornece instruções para instalação de uma nova versão do sistema Lyceum, incluindo:
1) Atualização do banco de dados e remoção de versões antigas;
2) Instalação do servidor Tomcat e dos módulos do Lyceum;
3) Configuração de portas, bancos de dados e autenticação.
Baixe no formato DOCX, PDF, TXT ou leia online no Scribd
Fazer download em docx, pdf ou txt
Você está na página 1de 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
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.
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