Construindo a Amostra Plants by WebSphere Utilizando a Ferramenta de Construção Ant



Portabilidade do J2EE
Reconstruindo as Amostras Fornecidas nesta Galeria
Introdução
Identificando a Estrutura de Diretórios
Reconstruindo e Instalando a Amostra

Portabilidade do J2EE

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.

Reconstruindo as Amostras Fornecidas nesta Galeria

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. 

Introdução

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.

Identificando a Estrutura de Diretórios

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.

Reconstruindo e instalando a Amostra

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
Transferindo o Arquivo PlantsByWebSphere.ear Reconstruído
Removendo e Reinstalando o Arquivo PlantsByWebSphere.ear

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:

  1. Abra um prompt de comandos.
  2. Na linha de comandos, mude para o diretório <raiz_do_perfil>/samples/src/PlantsByWebSphere.
  3. Execute o script de construção de Amostra:

  4. Digite o seguinte comando:


    <raiz_do_perfil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • Em plataformas de desenvolvimento Windows, digite o seguinte comando:

      <raiz_do_perfil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • Em plataformas de desenvolvimento UNIX e Linux, digite o seguinte comando:

      . <raiz_do_perfil>/samples/bin/PlantsByWebSphere/buildplantsby.sh

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.

Informações Importantes  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.

Transferindo o Arquivo PlantsByWebSphere.ear Reconstruído

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.

  1. Localize o arquivo EAR reconstruído no diretório <raiz_do_perfil>/samples/lib/PlantsByWebSphere
  2. Abra uma sessão de FTP para o WebSphere Application Server para z/OS ou iSeries a partir da plataforma de desenvolvimento.
  3. Altere o diretório para <raiz_do_perfil>/samples/lib/PlantsByWebSphere
    Pode ser necessário criar o diretório se ele não existir.
  4. Se o arquivo PlantsByWebSphere.ear existir, exclua-o de modo que o arquivo atualizado possa ser gravado.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

Removendo e Reinstalando o Arquivo PlantsByWebSphere.ear

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:

  1. Pare o servidor de aplicativos.
  2. Remova o arquivo EAR da Amostra Plants by WebSphere:
    1. Digite os seguintes comandos:

      cd <raiz_do_perfil>\bin
      setupCmdLine

      cd <raiz_do_perfil>/bin
      . ./setupCmdLine.sh

      Em plataformas z/OS:
      cd <raiz_do_perfil>/bin
      . ./setupCmdLine.sh

      Em plataformas iSeries:
      cd <raiz_do_perfil>/bin
      . ./setupCmdLine

      em que <raiz_do_perfil> representa o diretório de instalação do perfil.
    2. Digite o seguinte comando para desinstalar o aplicativo (raiz_do_perfil/bin deve estar em PATH):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Em plataformas z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Em plataformas iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Reinstale a Amostra do Plants by WebSphere:
    • Mude para o diretório raiz_do_perfil/samples/lib/PlantsByWebSphere.
    • Localize o arquivo PlantsByWebSphere.ear.
    • Digite o seguinte comando:

      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.

      Em plataformas z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>',
      		'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      Em plataformas iSeries:
      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.
  4. Inicie o servidor de aplicativos.

 

O arquivo PlantsByWebsphere.ear reconstruído agora foi implementado para o Application Server.