Faremos agora a instalação do TomCat 5.5
O TomCat é o programa que recebe as chamadas de seu Internet Explorer e as transforma em páginas. Este é o responsável pelo funcionamento de todas as suas aplicações.
Está sendo feito o processo de instalação da versão 5 e esta instalação é incompatível com versões anteriores do TomCat. Não foi testado com versões superiores, pois estas ainda não existiam no momento da construção deste manual.
Para iniciarmos, você deve fazer o Download do mesmo.
Neste momento, todas as outras instalações descritas neste roteiro necessitam estar concluídas para o correto funcionamento do mesmo.
Você pode fazer o download do TomCat 5.5 em:
Site oficial do TomCat
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/
Download
Para baixar o tomcat: mirrors.uol.com.br/pub/apache/tomcat/tomcat-5/v5.5.26/bin/apache-tomcat-5.5.26.exe
Para baixar o painel de administração do tomcat: mirrors.uol.com.br/pub/apache/tomcat/tomcat-5/v5.5.26/bin/apache-tomcat-5.5.26-admin.zip
Página de Downloads do TomCat
http://jakarta.apache.org/site/binindex.cgi
Após o Download, execute a instalação:
A tela de abertura da instalação será exibida.
Clique em Next.
Concorde com os termos de uso.
Clique em "I Agree"
No combo de seleção do tipo de instalação, escolha Full.
Clique em Next.
Estaremos utilizando o diretório padrão de instalação:
C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.5
Caso o mesmo seja alterado, você deve efetuar as alterações no restante da configuração deste roteiro.
Clique em Next.
Neste momento é solicitada informação sobre o funcionamento do servidor.
Caso você queira e tenha conhecimento, altere a porta para 80 ou outra de seu interesse.
Em todo este roteiro estaremos utilizando a porta 8080 e caso você não conheça bem esta configuração, não a altere. Você pode criar incompatibilidades com outros aplicativos e o mesmo pode não funcionar.
A configuração aconselhada é:
HTTP/1.1 Connector Porta: 8080
User name: admin
Password: <em branco>
Clique em Next.
Será solicitado o diretório onde se encontra instalado o Java Virtual Machine (JVM). Caso você tenha seguido a configuração padrão, o diretório escolhido deve ser: C:\Arquivos de programas\Java\jdk1.5.x
Caso você tenha alterado, escolha o diretório JDK de instalação do J2EE ou o diretório de instalação do J2SE.
Caso não tenha instalado conforme o padrão, o TomCat pode não encontrar os arquivos e simplesmente não instalar.
Clique em Install
O processo de instalação será executado.
Ao término, uma janela como esta será aberta para confirmar o término da instalação.
Neste momento o TomCat está instalado e deve estar pronto para funcionar.
Para que tenhamos certeza que o mesmo está funcionando, vamos iniciá-lo e testá-lo com os próprios exemplos existentes dentro dele.
Verifique se ao lado do relógio está o ícone do TomCat, como na figura abaixo:
Se este não estiver, inicie o programa clicando em Iniciar / Programas / Apache TomCat 5.5 / Monitor TomCat.
Note que no centro do ícone está um quadrado vermelho. Neste caso o TomCat está parado e deve ser iniciar para que funcione.
Clique com o botão direito sobre ele e clique em Configure...
Será aberto então uma janela de configuração. Nesta janela você poderá configurar como o TomCat deve comportar-se ao iniciar e quando isso deve ser feito.
PS: O funcionamento ou não do TomCat independe do ícone estar ao lado do relógio. Ou seja, mesmo que não esteja visível, o TomCat pode estar funcionando.
Em Startup type, você pode especificar quando e como o TomCat será iniciado.
Automatic - Será iniciado junto com o Windows
Manual - Você precisará inicia-lo manualmente.
Disabled - O TomCat não será mais iniciado.
Escolha a forma que você deseja iniciar o TomCat. É aconselhável que o mesmo esteja como Automatic. Clique em Aplicar.
Em Service Status irá aparecer Stopped se o TomCat estiver parado e Started se estiver em funcionamento.
Você pode parar ou iniciar o TomCat clicando nos botões abaixo:
Start - Inicia o TomCat
Stop - Para o TomCat
Pause - Suspende a execução do TomCat.
Restart - O mesmo que clicar em Stop e depois em Start.
Se o TomCat não estiver funcionando, clique em Start.
Ao clicar, uma janela como esta será exibida para o acompanhamento do processo de instalação:
Aguarde o término e verifique se o TomCat está realmente funcionando e clique em Ok.
Note que ao lado do relógio o ícone agora possui uma seta verde.
Com o TomCat iniciado e pronto para funcionar, vamos testar o funcionamento do mesmo.
Abra o Internet Explorer e abra a seguinte página:
http://localhost:8080
Uma página como a abaixo será aberta, demonstrando que o TomCat está funcionando.
A abertura desta página informa que o TomCat está funcionando, mas não informa que todos os componentes necessários para executar aplicações geradas pelo GeneXus estão funcionando.
Desta forma, iremos executar os exemplos do próprio TomCat e confirmar este funcionamento.Acesse o seguinte endereço:
http://localhost:8080/jsp-examples/
ou
http://localhost:8080/examples/jsp/
Uma página como esta será aberta.
Abaixo você encontrará os exemplos. Clique em Execute para ver os mesmos em funcionamento.
Após a validação de funcionamento do JSP, vamos testar os Servlets.
Acesse o seguinte endereço e proceda da mesma maneira:
http://localhost:8080/servlets-examples/
Saiba que você não precisa entender o funcionamento dos exemplos. A simples abertura dos mesmos na tela já informa que é possível de se executar.
Caso você encontre algum problema na execução destes, isto quer dizer que o problema está em sua instalação / configuração do TomCat.
Se os problemas ocorrerem na execução dos exemplos JSP, então é provável que seja o seu Internet Explorer, nos Servlets o problema provável é o SDK da Sun. Caso nem a primeira página consiga ser aberta, o seu TomCat não foi iniciado.Nestes casos, a melhor saída é a remoção dos programas, e a reinstalação dos mesmos.
Para evitar problemas, mantenha as configurações exatamente iguais a este documento, mantendo inclusive os diretórios exatamente iguais e em último caso utilize as mesmas versões descritas neste.Caso não resolva, tente iniciar a instalação em outro computador.
Entenda que até este momento não houve nenhuma interferência do GeneXus. Entre em contato com Fóruns ou pesquise sobre o erro encontrado no Google ou similar.
Somente continue a acompanhar este documento se todos os testes funcionaram perfeitamente e nenhum erro foi encontrado. Um erro irá inviabilizar o resto da instalação.om o TomCat funcionando, vamos criar um contexto para que o GeneXus consiga colocar os Setvlets e assim funcione corretamente.
Uma contexto é como se fosse um site, porém não iremos refinar nossa configuração a este nível e manteremos nossa aplicação em um contexto dentro do Host padrão (localhost).
Isso fará com que ao chamarmos o endereço http://localhost:8080/<contexto> a aplicação seja iniciada e exibida.
Para cada modelo e para cada kbase, você deverá ter um contexto definido e configurado. Não tente colocar dois ou mais kbases ou modelos no mesmo contexto. Isso irá causar a parada de sua aplicação.
Neste exemplo vamos criar um Contexto para os testes com nome de gxteste.
O Contexto iniciar com a criação de um diretório com o nome do próprio contexto e dentro uma estrutura de diretórios.
Todos os contextos devem ser criados dentro seguinte diretório:
C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.5\webapps
Dentro da pasta webapps, você deve criar os diretórios com o nome do contexto e com a seguinte estrutura de pastas:
Dentro da pasta webapps deve criado um diretório com o nome da aplicação. A estrutura deve ser como segue:
webapps
gxteste
imagens
WEB-INF
classes
lib
Nota: Para o TomCat, existe diferença entre Site e site. Uma letra maiúscula pode fazer com que o diretório não seja encontrado e o mesmo não funcione. Informe sempre tudo minúsculo quando não especificado o contrário.
O diretório imagens pode ter outro nome, como por exemplo, site, imgs, estatico, etc e o diretório WEB-INF deve ser digitado todo maiúsculo.Em futuras instalações, quando você desejar criar um contexto novo, monte os diretórios com a mesma estrutura, alterando somente o gxteste para o nome do seu novo contexto.
Não use acentos, espaços ou maiúsculas quando não especificado diretamente. Para o TomCat o arquivo não existe se você digitar http://localhost:8080/GxTeste. Este deve ser todo minúsculo para evitar problemas
Criar os diretórios do contexto não faz com que o mesmo seja criado dentro do TomCat. Você deve configurá-lo para que o mesmo entenda e funcione corretamente.
Para isso, você pode fazer via "TomCat Administration" ou criando um arquivo .xml.
Pela facilidade de montar o arquivo, optamos por esta forma. Você deve acessar o seguinte diretório:
C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.5\conf\Catalina\localhost
E dentro deste colocar um arquivo texto com o nome <contexto>.xml
Neste caso, o arquivo deve ter o seguinte nome: "gxteste.xml"
O conteúdo deste deve ser:
<?xml version="1.0" encoding="iso-8859-1"?>
<Context path="/gxteste" docBase="C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.5\webapps\gxteste"
debug="0" reloadable="true" crossContext="true">
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="localhost_dev_log." suffix=".txt" timestamp="true" />
</Context>
Caso você esteja criando um outro contexto, altere o nome e o diretório do conteúdo do arquivo para o nome do novo contexto.
O fato do contexto estar criado e configurado, não quer dizer que o mesmo esteja habilitado a executar Servlets. Desta forma, nenhuma aplicação GeneXus irá funcionar.
Para isso, você deverá criar um arquivo com nome "web.xml" dentro do diretório C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.5\webapps\gxteste\WEB-INF
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Desenvolvimento</display-name>
<description>
Descritor do contexto de desenvolvimento.
</description>
<servlet>
<servlet-name>invoker</servlet-name>
<servlet-class>
org.apache.catalina.servlets.InvokerServlet
</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>0</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>invoker</servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
</web-app>
Você pode alterar as tags display-name e description para alguma coisa mais personalizada, mas não existe a necessidade de alteração de nenhuma informação deste arquivo.
Nota: Existem diferenças no arquivo web.config para aplicações Web e para aplicações 3 camadas. Caso você esteja utilizando os dois ambientes, preste atenção para não trocar as configurações.
Atualizando o TomCat
Para se atualizar o TomCat, a melhor forma é parando o serviço e iniciando novamente. Isso faz com que o TomCat passe a trabalhar com as atualizações que foram feitas.
Todas as vezes quer alguma configuração for feita, a melhor coisa é parar e reiniciar o TomCat.
Desta forma, clique no lado do relógio no ícone do TomCat ou execute o TomCat Monitor para que este seja executado e pare e inicie o TomCat.
Para ver se as nossas alterações estão funcionando, precisamos acessar o TomCat.
Acesse o seguinte endereço:
http://localhost:8080/admin
Esta é a página Tomcat Administration do TomCat. Você pode também usar o link que se enconta na página inicial (http://localhost:8080/)
Faça o login e verifique se o Content se encontra dentro do Host localhost, como mostra a figura abaixo.
Clicando sobre o nome do Content, você poderá alterá-lo, mas evite qualquer tipo de alteração sem que você tenha conhecimento sobre o mesmo.
Uma vez o contexto existindo, vamos ver se o Servlet está funcionando. Para isso acesse o seguinte link:
http://localhost:8080/manager/html
Esta é a página Tomcat Manager do TomCat. Você também pode abrir pela página inicial e é exibida como abaixo:
Nela você encontra o seu servidor de servlet e se o mesmo está parado ou funcionando.
Se a palavra Start não estiver sublinhada (se não for um Link), seu servidor está funcionando perfeitamente.
Podemos então testar o contexto, para ver se o mesmo está funcionando. Mas é praticamente impossível que o mesmo não esteja.
Acesse o contexto:
http://localhost:8080/gxteste/
Uma janela como a abaixo deve ser aberta. Note que está escrito ?Directory Listing For /? e isto deve estar desta forma. Caso contrário pode estar havendo um erro.
Se você encontrou algum problema até este ponto, entenda que as configurações feitas na criação do contexto estão erradas.
Para resolver este problema, apague todo o diretório do contexto e o arquivo de configuração do mesmo, pare e inicie o TomCat e comece novamente.
Configurando o GeneXus Próximo passo