Creazione dell'esempio Plants by WebSphere utilizzando lo strumento di creazione Ant



Portabilità J2EE
Ricreazione di esempi forniti in questa raccolta
Introduzione
Identificazione della struttura di directory
Ricreazione ed installazione dell'esempio

Portabilità J2EE

Uno dei vantaggi principali nelle applicazioni di sviluppo su una piattaforma J2EE è la portabilità. Tutti i programmi di esempio nella Raccolta di esempi sono sviluppati su una stazione di lavoro ed eseguiti sui sistemi z/OS e iSeries senza modificare alcuna riga del codice Java.  Creando le applicazioni J2EE sui sistemi Intel o UNIX, uno sviluppatore è in grado di eliminare le problematiche delle conversioni file EBCDIC in ASCII o ASCII in EBCDIC.  La disponibilità di strumenti rende più semplice agli sviluppatori scrivere e verificare su una stazione di lavoro di sviluppo ed installare i file EAR (enterprise archive) sui sistemi z/OS e iSeries.

Ricreazione degli esempi forniti in questa raccolta

Ciascun cliente di WebSphere Application Server (server delle applicazioni) per z/OS e iSeries è autorizzato all'utilizzo del supporto del server delle applicazioni per più piattaforme. Se si installa il prodotto di base WebSphere Application Server e gli esempi su una delle piattaforme supportate da questo package, viene visualizzata la stessa raccolta. L'unica eccezione è che quando si seleziona nome_esempio > Crea con Ant > piattaforma > Ricreazione e installazione del file sample.ear, vengono visualizzate le istruzioni per ricreare il file EAR su tale piattaforma.  Poiché i file di testo in un file EAR  (XML, xmi, file JSP (JavaServer Page) e così via) devono essere in formato ASCII, è più semplice modificare questi file su una macchina ASCII. Se si apportano modifiche su una macchina ASCII, è possibile poi distribuire ed installare il file EAR risultante su una piattaforma z/OS o iSeries, senza dover convertire il formato EBCDIC in ASCII. 

Introduzione

Installare WebSphere Application Server sulla piattaforma distribuita desiderata e indicare di installare le applicazioni di esempio del server delle applicazioni.

Eseguire una copia di backup della directory <root_profilo>/samples  prima di tentare di modificare o ricreare gli esempi. Creare un file zip della directory samples. È possibile ripristinare la directory samples allo stato originale, estraendo il file zip.

Identificazione della struttura della directory

Gli esempi vengono installati nelle seguenti directory:


<root_profilo>/samples/src/PlantsByWebSphere Contiene il codice sorgente dell'esempio Plants by WebSphere.
<root_profilo>/samples/lib/PlantsByWebSphere Contiene i file WAR (Web archive), i file JAR (Java archive) e il file PlantsByWebSphere.ear per l'esempio Plants by WebSphere. Questa directory viene creata dopo la ricreazione dell'esempio Plants by WebSphere.
<root_profilo>/samples/javadoc/PlantsByWebSphere Contiene la documentazione Javadoc. Questa directory viene creata dopo la ricreazione dell'esempio Plants by WebSphere.
<root_profilo>/samples/bld/PlantsByWebSphere Contiene i file di classe generati. Utilizzare questi file di classe per generare il file finale PlantsByWebSphere.ear. Questa directory viene creata dopo la ricreazione dell'esempio Plants by WebSphere.

Ricreazione e installazione dell'esempio

L'esempio Plants by WebSphere viene installato automaticamente con WebSphere Application Server. Non è necessario creare l'esempio prima di utilizzarlo. Le seguenti istruzioni descrivono la procedura per ricreare l'esempio, con ulteriori informazioni per le modifiche.


Esecuzione dello script di creazione degli esempi
Trasferimento del file PlantsByWebSphere.ear ricreato
Rimozione e reinstallazione del file PlantsByWebSphere.ear

Esecuzione dello script di creazione degli esempi

Per ricreare questo esempio, verificare che la directory root_profilo/bin sia presente nella variabile di ambiente PATH. Seguire queste istruzioni per eseguire lo script di creazione degli esempi, che crea nuovamente l'esempio:

  1. Aprire un prompt di comandi:
  2. Sulla riga comandi, passare alla directory <root_profilo>/samples/src/PlantsByWebSphere.
  3. Eseguire lo script di creazione dell'esempio:

  4. Digitare il seguente comando:


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


    • Sulle piattaforme di sviluppo Windows, immettere il seguente comando:

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


    • Sulle piattaforme di sviluppo UNIX e Linux, immettere il seguente comando:

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

L'esempio è stato creato.

Gli script buildplantsby.bat e buildplantsby.sh contenuti nella directory root_profilo/samples/bin/PlantsByWebSphere consentono di impostare le informazioni del percorso di classe e di eseguire il programma di utilità di creazione Ant appropriato. Il programma Ant legge i file build.xml, che descrivono come creare l'esempio. Per ulteriori informazioni sulla documentazione relativa a Ant, fare riferimento al sito Web di Jakarta .

Informazioni importanti  Durante il processo di generazione, verranno ricreati solo i file di classe che sono stati modificati. I file di classe rimanenti verranno compressi in un nuovo file EAR.

Trasferimento del file PlantsByWebSphere.ear ricreato

Utilizzare FTP (File Transfer Protocol) per trasferire il file EAR binario sul server z/OS o iSeries, utilizzando le seguenti istruzioni.

  1. Rilevare il file EAR ricreato nella directory <root_profilo>/samples/lib/PlantsByWebSphere
  2. Aprire una sessione FTP in WebSphere Application Server per z/OS o iSeries dalla piattaforma di sviluppo
  3. Passare alla directory <root_profilo>/samples/lib/PlantsByWebSphere
    Se non esiste, creare questa directory.
  4. Se il file PlantsByWebSphere.ear esiste, cancellarlo, in modo che possa essere scritto il file aggiornato.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

Rimozione e reinstallazione del file PlantsByWebSphere.ear

Per impostazione predefinita, l'esempio Plants by WebSphere viene installato nella directory root_profilo/installedApps/<nome cella>, dove <nome cella> è il nome della cella in cui è installata l'applicazione. Installare di nuovo l'esempio come indicato di seguito:

  1. Arrestare il server delle applicazioni.
  2. Per rimuovere il file EAR di esempio Plants by WebSphere:
    1. Immettere i seguenti comandi:

      cd <root_profilo>\bin
      setupCmdLine

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

      Su piattaforme z/OS:
      cd <root_profilo>/bin
      . ./setupCmdLine.sh

      Su piattaforme iSeries:
      cd <root_profilo>/bin
      . ./setupCmdLine

      dove <root_profilo> indica la directory di installazione del profilo.
    2. Immettere il seguente comando per disinstallare l'applicazione (root_profilo/bin deve essere presente nella variabile di ambiente PATH):

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

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

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

      Su piattaforme iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Reinstallare l'esempio Plants by WebSphere:
    • Passare alla directory root_profilo/samples/lib/PlantsByWebSphere.
    • Individuare il file PlantsByWebSphere.ear.
    • Digitare il seguente comando:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nodo>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'intero esempio.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nodo>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'intero esempio.

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

      Su piattaforme iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<nodo>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'intero esempio.
  4. Avviare il server delle applicazioni.

 

Il file creato PlantsByWebsphere.ear è stato distribuito al server delle applicazioni.