Deployment Wizard com Web Start
O Deployment Wizard é uma aplicação GeneXus em Java que gera instalações para as aplicações geradas pelo próprio GeneXus. No caso de aplicações com interface gráfica é gerada a instalação com o Web Start, uma aplicação que faz a instalação de forma automática nos clientes de destino de forma simples e fácil.
Seu funcionamento é simples e para iniciar este processo, você deve.
Gerando o Web Start
Com o GeneXus aberto, pressione F5.
Escolha DeveloperMenu e clique em Executar.
Uma janela como esta é aberta:
Clique em Utilities / Deployment Wizard
Escolha quais Mains farão parte desde Deployment e clique para movê-los para a parte direta da tela.
Neste nosso exemplo, iremos gerar a instalação da WorkPanel sem acesso ao banco de dados.
Clique em Next.
Caso você tenha alguma classe adicionada manualmente em seu sistema, clique em "Add classes". Isso só é feito em casos especiais.
Caso contrário, clique em Next.
Marque o "Transfer location files", escolha "Transfer Mode" como Copy e o Target Directory para algum diretório vazio dentro de seu computador.
Neste diretório serão criados os arquivos do Web Start, ou seja, neste diretório é que serão gerados os arquivos de instalação.
Neste exemplo, foi criado um diretório C:\WebStart para este fim.
Clique em Finish
VM: Informe a Virtual Machine a ser utilizada. Desaconselhamos completamente o uso da Virtual Machine Microsoft, pois a mesma se encontra descontinuada. Desta forma, selecione "Sun".
Marque Include Dependencies e informe quais são as classes deverão ser levadas ao seu cliente durante a instalação. Basicamente você deve incluir todas as classes presentes no seu ClassPath.
Nota: Você não pode incluir os arquivos do diretório DATA00x. Neste caso, uma mensagem de erro como esta irá aparecer:
Então, você deve incluir os arquivos do diretório de instalação dos mesmos. Explicaremos o motivo mais adiante.
Os arquivos que devem ser incluídos são:
GeneXus " Diretório "C:\Arquivos de programas\ARTech\GeneXus\gxw80\gxjava
o gxclassr.zip
o iText.jar
o swt.jar
o swt-win32-3019.dll
o swt.mdi.win32.0.2.dll
- Driver JDBC " Diretório " C:\Arquivos de programas\Microsoft SQL Server 2000 Driver for JDBC\lib
- msbase.jar
- mssqlserver.jar
- msutil.jar
Nota: Caso você tenha instalado o GeneXus ou o driver JDBC em outro diretório, você deve ajustar conforme sua realidade.
Caso você esteja utilizando drivers JDBC para outro banco de dados, você deve incluir os que você irá utilizar.
Dependencies Subpath: Diretório dentro do Target Directory (Onde será gerado o Setup de sua aplicação) onde serão gravados os arquivos de Dependência informados.
Application Name: Texto descritivo contendo o Nome de sua aplicação (Não use acentos ou caracteres especiais).
Description: Descrição simples do conteúdo de sua aplicação.
Vendor: Informe o nome de sua empresa.
Version: Deixando marcado o Autoincrement version, a cada geração do Web Start, será incrementada a versão.
Clique em "Build Archives" e aguarde o término da geração dos arquivos.
Neste momento é gerado no diretório de destino alguns arquivos contendo a instalação de sua aplicação e a geração de sua instalação está encerrada.
Nota: Dependendo da configuração de seu ambiente, pode ser que você tenha o erro abaixo:
Neste momento o GeneXus prepara a "certificação" com a assinatura digital de todos os pacotes que serão instalados em seu cliente para evitar que alguém troque uma classe por outra contendo alterações que possam comprometer a segurança ou o funcionamento do mesmo.
Esta assinatura por meio de Manifest e CheckSum é feita por dois arquivos inseridos dentro dos arquivos .jar.
Então, o GeneXus passa o controle ao Java que faz a assinatura, mas o Java não consegue definir de ele mesmo está utilizando a classe que ele precisa assinar ou não.
Você deve neste caso alterar o ClassPath dentro do GeneXus para que ele consiga "controlar" o Java e forçar a utilização de outra classe que não será utilizada.
Feche o Deployment Wizard e volte ao GeneXus.
Pressione F5 e clique em Options .
Na opção ClassPath que está:
gxclassr.zip;iText.jar;swt.jar;msbase.jar;mssqlserver.jar;msutil.jar;.;
Você deve alterar para:
C:\Arquivos de programas\ARTech\GeneXus\gxw80\gxjava\gxclassr.zip;C:\Arquivos de programas\ARTech\GeneXus\gxw80\gxjava\swt.jar;.;
Nota: Caso esteja utilizando outros diretórios para a instalação do GeneXus, altere e especifique o diretório correto. As informações devem ser válidas.
Volte e execute novamente o processo para a geração pelo Deployment Wizard. Note que as opções informadas anteriormente já se encontram selecionadas.
Após a geração do Web Start uma vez, volte e deixe a ClassPath como estava antes para o correto funcionamento de sua aplicação.
Em futuras utilizações você não precisa fazer esta alteração novamente. Uma vez o pacote assinado, este não é mais alterado.
<o:p> </o:p>
Caso algum upgrade do GeneXus ou do Java seja aplicado, este erro pode voltar a ocorrer e é só executar este mesmo processo novamente.
Building archives...
Retrieving information of C:\Arquivos de programas\ARTech\GeneXus\gxw80\gxjava\gxclassr.zip
com.genexus.gx.deployment.GXWSException: gxclassr.zip doesn't contain META-INF/CHECKSUM.INF
'gxclassr.zip' will be deleted and a backup copy will be renamed to 'gxclassr.zip.bad'
Cannot create backup file 'gxclassr.zip.bad'
java.lang.Exception: 'gxclassr.zip' cannot be deleted!
<o:p> </o:p>
<o:p> </o:p>
<o:p>
Com o Web Start gerado, só precisamos publicar o mesmo para que seja feita a instalação e auto-atualização das aplicações.
Esta instalação deve ser feita por um servidor Web, porém entenda que o mesmo pode estar dentro de sua empresa e não precisa ficar disponível na Internet.
Este processo visa a facilidade de instalação e atualização de sua aplicação.
Caso você tenha o IIS instalado em seu computador, mesmo que ele não seja o servidor, você pode prover o serviço e a partir de seu equipamento pode ser feita a instalação de sua aplicação.
O processo é simples:
Abra o Windows Explorer e clique com o botão direito sobre o diretório onde você gerou sua aplicação, que em nosso exemplo é WebStart e clique em Compartinhamento e segurança....
Escolha a Aba "Compartilhamento da Web", Clique em "Compartilhar esta pasta" e clique em Ok.
Anote o Alias gerado para que seja encontrado mais a frente.
Nota: Caso não exista a Aba "Compartilhamento da Web", significa que você NÃO tem o Internet Information Server (IIS) instalado em seu computador.
Para resolver este problema você pode instalar o IIS em seu computador clicando em "Adicionar e Remover programas" no painel de controle e em "Adicionar / Remover Componentes do Windows".
Outra possibilidade seria a utilização de outro Windows que já possua o IIS instalado. Para isso, copie o diretório e execute o processo.
O processo com TomCat é um pouco mais complicado.
Estamos levando em conta que você está utilizando TomCat 5 e o mesmo já se encontra instalado e funcionado.
Copie o diretório e os arquivos para dentro do diretório webapps do TomCat, conforme imagem:
Crie um arquivo texto e renomeie para como nome sugerido de "webstart.xml" (lembre-se que para o TomCat EXISTE diferença entre maiúsculo e minúsculo) com o seguinte texto:
<?xml version="1.0" encoding="iso-8859-1"?>
<Context path="/webstart" docBase="C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.0\webapps\webstart"
debug="0" reloadable="true" crossContext="true">
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="localhost_dev_log." suffix=".txt" timestamp="true" />
</Context>
Aconselha-se a utilizar o nome do arquivo com o mesmo nome do contexto que será criado.
Neste exemplo, o contexto que será criado se chama /webstart e que está fisicamente em C:\Arquivos de programas\Apache Software Foundation\Tomcat 5.0\webapps\webstart.
Com estas alterações, pare e inicie o TomCat. Seu contexto estará criado e pronto para ser utilizado.
Você pode instalar uma aplicação sim sem servidores Web, porém desta forma sua aplicação não fará uma auto-atualização.
Para isso, abra o Windows Explorer e dê um duplo-clique sobre os arquivos HTML que se encontram no diretório de instalação e acompanhe o restante do documento.
Antes de qualquer coisa é importante saber que o Web Start não instala o Java na máquina do cliente.
Caso não tenha instalado, você deve instalar. Uma forma fácil de instalar o Java da Sun é acessar esta página da Web e o processo de instalação é feito automaticamente:
Inglês:
http://java.com/en/download/download_the_latest.jsp
Espanhol:
http://java.com/es/download/download_the_latest.jsp
Após a abertura da página, clique no botão dentro da página e aguarde o término da instalação.
Com o seu servidor Web instalado, sua aplicação publicada e seu cliente com a VM da Sun instalada, você deve acessar a página Web e efetuar a instalação.
Para isso abra o Interner Explorer e acesse o seguinte endereço:
http://<Computador>/<Pasta_Virtual>/Arquivo.html
Onde:
" Computador " É o nome do computador na rede onde está instalado o servidor Web. (Lembre-se que o TomCat inclui :8080 após o nome por default para alterar a porta no servidor).
" Pasta Virtual " Para o IIS, utilize o Alias anotado na instalação. Para o TomCat, utilize o Contexto criado (Lembre-se que para o TomCat existe diferença entre Maiúsculo e Minúsculo).
" Arquivo.html " É o nome do arquivo que está dentro do diretório onde foi gerado o Setup e que contém o nome de sua aplicação.
<o:p> 
</o:p>
Pronto! O processo foi iniciado.
Caso você tenha um site interno, você pode fazer um link para esta página sem problemas e então facilitar o processo de instalação.
Para iniciar a instalação, simplesmente clique no link da página.
Será aberta uma janela para certificar que você confia nos componentes que serão instalados. Clique em Yes.
O Web Start é executado e o processo de instalação se inicia.
Neste momento é então verificado se seu usuário possui realmente direito de instalar a aplicação.
Dependendo do servidor Web (IIS, TomCat, etc) e do ambiente onde estiver instalado (Windows / Linux), a janela pode conter informações diferentes ou simplesmente pode não ser solicitado.
Neste exemplo, estamos utilizando o IIS e a senha solicitada é a senha de usuário do Windows.
Com acesso, o processo é finalmente iniciado.
No término, sua aplicação é executada.
Sua aplicação foi instalada com sucesso e a página Web utilizada para a instalação e sua aplicação podem ser fechadas sem problemas.
O processo de instalação é executado uma única vez e não mais.
Para executar sua aplicação, clique em Iniciar / Programas e execute sua aplicação.
O Web Start sempre verifica no servidor Web de onde ele foi instalado se existe no mesmo local uma versão mais nova.
Caso exista, a mesma é instalada automaticamente.
Nota: Você pode instalar o aplicativo sem a utilização de um servidor Web, simplesmente abrindo o .html com um duplo-clique.
Porém isso não faz um vínculo entre sua aplicação e o local onde a mesma será atualizada e uma mensagem como esta é exibida.
Aplicações como esta mensagem não são atualizados automaticamente.
Após clicar em Ok, outra janela é aberta:
Independente de receber ou não esta mensagem, a mesma NÃO será atualizada.
Simplesmente abra o Painel de Controle e clique em Adicionar ou Remover Programas e remova o programa.
Simplesmente gere novamente o Web Start e atualize os arquivos no servidor. Nas próximas execuções, a aplicação será atualizada automaticamente.
Nota: Se houve alterações na base de dados, você deve rodar o RMenu também.
Este programa controla o funcionamento de todas as aplicações GeneXus instaladas no computador e fornece mais poder de configuração de suas aplicações e instalações.
Para executar, clique em Iniciar / Programas
<o:p> </o:p>
Executando o RMenu em seu cliente(Java Win)
Artech do Brasil
</o:p>