Plants by WebSphere |
|
Introdução |
Identificando a Estrutura de Diretórios |
Reconstruindo e Instalando a Amostra |
Um dos maiores benefícios do desenvolvimento de aplicativos em
uma plataforma J2EE é a portabilidade. Todos os programas de
Amostra na Galeria de Amostras são desenvolvidos em uma estação de
trabalho e executam em sistemas z/OS e iSeries sem alterar uma linha
do código Java.
Ao construir aplicativos J2EE em
sistemas Intel ou UNIX, um desenvolvedor pode eliminar os desafios
das
conversões de arquivos EBCDIC para ASCII ou ASCII para EBCDIC.
A disponibilidade de ferramentas facilita que os desenvolvedores
criem e testem em uma estação de trabalho de desenvolvimento e
instalem os arquivos EAR (Enterprise Archive) em sistemas z/OS e
iSeries.
Cada WebSphere Application Server (servidor de aplicativos) para
cliente z/OS e iSeries tem direito à mídia do Application Server
para multiplataformas. Se você instalar o produto base WebSphere
Application Server e as Amostras em uma das plataformas suportadas
por este pacote, você verá a mesma galeria. A única exceção é
que, ao clicar em nome_da_amostra > Construir com Ant > plataforma > Reconstruindo e Instalando o Arquivo sample.ear, você obterá instruções
para reconstruir o arquivo EAR nessa plataforma. Como os
arquivos de texto em um arquivo EAR (XML, xmi, arquivos JSP
(JavaServer Pages) e assim por diante) devem estar em um
formato ASCII, é mais fácil editar estes arquivos em uma máquina
ASCII. Se fizer alterações em uma máquina ASCII, será possível
implementar e instalar o arquivo EAR resultante na plataforma z/OS ou
iSeries sem uma conversão de EBCDIC para ASCII.
Instale o WebSphere Application Server na plataforma distribuída de sua escolha e indique a instalação dos aplicativos de Amostra do Application Server.
Faça uma cópia de backup do diretório <raiz_do_perfil>/samples antes de tentar modificar ou reconstruir as Amostras.Crie um arquivo zip do diretório samples. Você pode restaurar o diretório samples para seu estado original extraindo o arquivo zip.
As Amostras são instaladas nos seguintes diretórios:
<raiz_do_perfil>/samples/src/PlantsByWebSphere | Contém o código-fonte da Amostras para a Amostra do Plants by WebSphere. |
<raiz_do_perfil>/samples/lib/PlantsByWebSphere | Contém os arquivos WAR, JAR e o arquivo final PlantsByWebSphere.ear para a Amostra do Plants by WebSphere. Este diretório é criado após a construção da Amostra do Plants by WebSphere. |
<raiz_do_perfil>/samples/javadoc/PlantsByWebSphere | Contém a documentação Javadoc. Este diretório é criado após a construção da Amostra do Plants by WebSphere. |
<raiz_do_perfil>/samples/bld/PlantsByWebSphere | Contém os arquivos de classe gerados. Utilize esses arquivos de classe para gerar o arquivo final PlantsByWebSphere.ear. Este diretório é criado após a construção da Amostra do Plants by WebSphere. |
A Amostra do Plants by WebSphere é instalado automaticamente com o WebSphere Application Server. Não é necessário construir a Amostra do Plants by WebSphere antes de utilizá-lo. As instruções a seguir descrevem as etapas para reconstruir a Amostra, com informações adicionais para modificações.
Executando o Script de Construção de Amostra |
Para reconstruir esta amostra, verifique se raiz_do_perfil/bin está em sua variável de ambiente PATH.Siga estas etapas para executar o script de construção de Amostra, que reconstrói a Amostra:
Agora a Amostra foi construída.
O script buildplantsby.bat e buildplantsby.sh no diretório raiz_do_perfil/samples/bin/PlantsByWebSphere configuram as informações do caminho de classe apropriadas e executam o utilitário de construção Ant. O Ant lê os arquivos build.xml, que descrevem como construir a Amostra. Consulte o Web site do Jakarta para obter a documentação adicional do Ant.
Durante o processo de construção, apenas os arquivos de classe que possuem alterações são reconstruídos.
Os arquivos de classe restantes são empacotados novamente em um novo arquivo EAR.
Utilize o FTP (Protocolo de Transferência de Arquivos) para transferir o arquivo EAR binário para o servidor z/OS ou iSeries, utilizando as instruções a seguir.
Por padrão, a Amostra do Plants by WebSphere é instalada no diretório raiz_do_perfil/installedApps/<cell name>, em que e <cell name> é o nome da célula onde seu aplicativo está instalado.
Reinstale a Amostra conforme descrito nas etapas a seguir:
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
O arquivo PlantsByWebsphere.ear reconstruído agora foi implementado para o Application Server.