2 Requisitos Mínimos Visão Geral 2 Instalando o SDK... da Sun 3 Instalando o Tomcat... do Apache Jakarta Project 4 Instalando o WebIntegrator

Transcrição

1 Conteúdo I Conteúdo Part I Introdução 2 1 Apresentação Requisitos Mínimos... 2 Part II Instruções de Instalação 2 1 Visão Geral Instalando o SDK... da Sun 2 3 Instalando o Tomcat... do Apache Jakarta Project 3 4 Instalando o WebIntegrator... 3 Part III Configuração do Tomcat 3 1 Iniciar e Parar... Tomcat 3 Part IV Executando o WebIntegrator 5 1 Fazendo o Deploy Rodando o WebIntegrator... 5 Índice 0 I

2 2 Install WebIntegrator 3 1 Introdução 1.1 Apresentação O WebIntegrator é uma ferramenta para o desenvolvimento de aplicações Web, cujo grande diferencial é a facilidade de uso. Construído em Java, é multiplataforma e integra-se facilmente com a maioria dos bancos de dados (via ODBC ou JDBC). Além de ser um servidor de aplicações, o WebIntegrator possui um ambiente de desenvolvimento integrado que requer apenas um browser para ser utilizado, permitindo o desenvolvimento remoto de aplicações. WebIntegrator é indicado para o desenvolvimento de novos sistemas de informação com arquitetura cliente/servidor em 3 camadas, modernização de aplicações legadas com a introdução da interface Web, aplicações de workflow e construção de portais para e-business e para publicação de conteúdo. 1.2 Requisitos Mínimos Os requisitos mínimos do sistema necessários para executar o WebIntegrator 3 (WI Builder e WI Report ), são: equipamento rodando sob a palataforma Windows 2000/XP ou Linux; memória miníma recomendada de 128Mb; possuir instalados e configurados o pacote SDK e o Tomcat. É fundamental, antes de instalar o WebIntegrator, ter baixado e instalado o pacote JSDK (v1.4.1.x) e o servidor Tomcat (v4.1.x). 2 Instruções de Instalação 2.1 Visão Geral Este tutorial foi inicialmente escrito e testado com base em uma instalação do WebIntegrator WI_Builder v com o pacote Java SDK mais Apache Tomcat em Windows XP. As configurações aqui propostas são para criar um ambiente de desenvolvimento bem simples, suficiente para um primeiro contato com o WebIntegrator. O primeiro passo antes de instalar o WebIntegrator é baixar e instalar o pacote J2SE Software Development Kit (SDK) versão (ou superior); posteriormente, instalar o Apache Tomcat versão (ou superior). Somente após a instalação do SDK e do Tomcat é que instalamos o WebIntegrator. 2.2 Instalando o SDK da Sun Se você ainda não baixou o pacote SDK, então faça-o agora acessando a página: Concluído o download, localize o arquivo e execute-o. A instalação do SDK é bem simples e rápida. Pode instalar com todas as opções padrão, é só ir clicando no botão Next >. É sempre bom verificar se o seu diretório Java está no caminho correto (PATH), para isso abra uma janela de Prompt de comando e digite: java -version. A versão que aparecerá como resposta tem que ser a mesma que

3 Instruções de Instalação 3 você acabou de instalar. 2.3 Instalando o Tomcat do Apache Jakarta Project Quando este tutorial foi editado, as versões estáveis mais recentes eram Tomcat (APIs Servlet 2.3 e JSP 1.2, integrantes do J2EE 1.3). O download do instalador para Windows pode ser acessado no site primário a partir de um arquivo binário, zipado, que encontra-se no site do Projeto Jakarta, enderço: A página principal de download apresenta todas as alternativas de versões e mirrors (locais de download). Localize o arquivo correspondente ao seu sistema operacional e baixe-o. O próximo passo é extrair os arquivos para a raiz de sua unidade C:\. Observando o arquivo zipado, percebemos que ele contém a estrutura de pastas que o Tomcat usará no momento da descompactação. Finalizada a extração dos arquivos, precisamos agora editar o arquivo CATALINA.BAT que estará dentro da pasta \jakarta-tomcat \bin. Então, logo abaixo da linha que contém off, você deverá incluir a seguinte sentença: set java_home=c:\j2sdk1.4.2_04. Para fazermos o deploy do WebIntegrator precisaremos de um usuário admin cadastrado no servidor. Para isso edite o arquivo TOMCAT-USERS.XML que está localizado na pasta \jakarta-tomcat \conf e inclua o usuário admin com senha admin, conforme as linhas abaixo: <role rolename="admin"/> <user username="admin" password="admin" roles="manager,admin"/> 2.4 Instalando o WebIntegrator Concluída toda a fase inicial de instalação e configuração do pacote SDK e o Tomcat, agora devemos descompactar o arquivo zipado do WI3. Dê preferência para descompactação na raiz da sua unidade C:\ deixando que o WinZip extraia automáticamente as pastas e subpastas adotando a estrutura de diretórios-padrão. Concluindo este processo, a raiz da sua unidade C:\ agora deverá conter uma pasta \wibuilder-3_0_10. Pronto, o WI3 está instalado! 3 Configuração do Tomcat 3.1 Iniciar e Parar Tomcat Chegou o momento de testar se o seu servidor Tomcat está funcionando corretamente. Para iniciar/parar o serviço, você precisará dos arquivos startup.bat para iniciar e o shutdown.bat para parar. Estes arquivos batch estão na pasta \jakarta-tomcat \bin. A fim de agilizar o processo (iniciar/parar), aconselhamos a criação de atalhos para estes arquivos na área de trabalho do seu computador. Para testar se o Tomcat está rodando "ok", após iniciado, abra o browse e vá para o endereço: Neste momento a home-page padrão do Tomcat aparecerá no seu navegador, o link Tomcat Documentation dá acesso a toda a documentação necessária, instalada localmente; o link Tomcat Administration permite criar, excluir e configurar serviços e autorizações; o link Tomcat Manager

4 4 Install WebIntegrator 3 permite gerenciar as aplicações iniciar, parar, re-iniciar, fazer deploy (distribuição) e undeploy bem como monitorar o estado do servidor. Para parar o serviço iniciado anteriormente execute o arquivo shutdown.bat, ou pressione <CTRL> + <C> com a janela do serviço STARTUP.BAT ativa. IMPORTANTE: se você ainda não entende bem a estrutura e características da configuração de um servidor de aplicação web Java como o Tomcat, não altere nada sem saber. Você pode contudo acessar a ferramenta de Gerenciamento (Tomcat Manager), fornecer o login e senha do usuário administrativo configurado na instalação e visualizar o Estado do Servidor, que apresenta uma série de informações técnicas sobre o funcionamento do servidor Tomcat. SOLUCIONANDO PROBLEMAS DE INSTALAÇÃO: possívelmente podem ocorrer problemas na instalação do Tomcat e por isso a sua home-page padrão poderá não vir a ser apresentada. Para podermos ver qual erro o STARTUP.BAT está retornando, é necessário fazer uma pequena modificação no arquivo que se localiza na pasta \jakarta-tomcat \bin. Onde tem o comando: call "%EXECUTABLE%" start %CMD_LINE_ARGS% Troque por: call "%EXECUTABLE%" run %CMD_LINE_ARGS% pause Um dos problemas mais comuns é o conflito com a porta padrão de comunicação do Tomcat, que é a porta Se você possui outro aplicativo de comunicação em rede que usa essa porta, ela não ficará disponível para o Tomcat. Ocorrendo isso, edite o arquivo SERVER.XML que se encontra na pasta \jakarta-tomcat \conf, e troque a porta 8080 na entrada <Connector /> conforme abaixo. Exemplo: Trocando a entrada <Connector /> com port=8080 <Connector classname="org.apache.coyote.tomcat4.coyoteconnector" port="8080" minprocessors="5" maxprocessors="75" enablelookups="true" redirectport="8443" acceptcount="100" debug="0" connectiontimeout="20000" useurivalidationhack="false" disableuploadtimeout="true" /> Por este <Connector /> com port=80 <Connector classname="org.apache.coyote.tomcat4.coyoteconnector" port="80" minprocessors="5" maxprocessors="75" enablelookups="true" redirectport="8443" acceptcount="100" debug="0" connectiontimeout="20000" useurivalidationhack="false" disableuploadtimeout="true" /> Outro erro muito comum é ter o Tomcat já iniciado como serviço e tentar iniciá-lo novamente, como processo. O processo não conseguirá ser iniciado, acusando que já existe algum servidor utilizando a sua porta. Neste caso, obviamente seria necessário antes parar o serviço, se realmente fosse desejado iniciar o Tomcat como processo. Quando o Tomcat é iniciado como processo console, abre-se uma janela console (modo-texto). Mantenha a janela aberta e não feche manualmente. A janela console fecha automaticamente quando é acionado o comando de encerrar o processo (shutdown.bat do Tomcat).

5 Executando o WebIntegrator 5 4 Executando o WebIntegrator 4.1 Fazendo o Deploy Agora que estamos com todo o ambiente instalado e configurado, chegou a hora de começar a usar o WebIntegrator. É necessário fazer o deploy do arquivo WI3.WAR que está na pasta \wibuilder- 3_0_10. Para fazer isso, abra o browse com a página do Tomcat ativa, não esqueça de "startar" o serviço antes de chamar o browse. Clicando no link Tomcat Manager aparecerá uma janela de login pedindo o nome de usuário e senha. Digite admin na linha de usuário e repita admin na senha. Navegando pela página você encontrará um campo com a seguinte descrição: Select WAR file to upload, então, clique no botão que está ao lado (Browse ou Procurar, dependendo do navegador que você esteja usando) e localize o arquivo WI3.WAR em sua unidade. Depois é só clicar no botão Install/Instalar para fazer o upload do arquivo.war para o seu Servidor Tomcat. Concluída esta operação, na própria página do Tomcat aparecerá /wi3 na lista de aplicações disponíveis (applications), então, é só clicar direto no link /wi3 ou digitar o endereço: localhost/wi3 4.2 Rodando o WebIntegrator Quando a pagina do WebIntegrator estiver no ar (ativa), clique no link Builder para aparecer a janela do WI3-Builder. Após isso, basta clicar no botão Aceito os termos deste contrato para começar a desenvolver sua primeira aplicação.