Beispiel Plants By WebSphere mit dem Build-Tool Ant erstellen



J2EE-Portierbarkeit
Die Beispiele, die mit dieser Galerie geliefert werden, erneut erstellen
Erste Schritte
Verzeichnisstruktur
Beispiel erneut erstellen und installieren

J2EE-Portierbarkeit

Einer der großen Vorzüge beim Entwickeln von Anwendungen auf einer J2EE-Plattform ist die Portierbarkeit. Alle Beispielprogramme in der Beispielgalerie wurden auf einer Workstation entwickelt und können ohne die geringste Änderung des Java-Codes auf z/OS- und iSeries-Systemen ausgeführt werden. Wenn ein Entwickler J2EE-Anwendungen auf Intel- oder UNIX-Systemen erstellt, kann er die Schwierigkeiten, die bei der EBCDIC-zu-ASCII- bzw. der ASCII-zu-EBCDIC-Dateikonvertierung auftreten können, umgehen. Mit den verfügbaren Tools können Entwickler problemlos Code auf einer Entwicklungs-Workstation schreiben und testen und die EAR-Dateien auf z/OS- und iSeries-Systemen installieren.

Die Beispiele, die mit dieser Galerie geliefert werden, erneut erstellen

Jeder Kunde, der WebSphere Application Server (Application Server) für z/OS und iSeries erworben hat, ist berechtigt, die Application Server Media für Multiplatforms zu nutzen. Wenn Sie das Basisprodukt WebSphere Application Server und die Beispiele auf einer der von diesem Paket unterstützten Plattformen installieren, sehen Sie dieselbe Galerie. Wenn Sie auf Beispielname > Eigenen Build erstellen - Ant > Plattform > Datei sample.ear erneut erstellen und installieren klicken, erhalten Sie Anweisungen, mit denen Sie die EAR-Datei auf dieser Plattform erneut erstellen können. Da Textdateien in einer EAR-Datei (XML, XMI, JSP usw.) ASCII-Format haben müssen, ist es einfacher, diese Dateien auf einer ASCII-Maschine zu bearbeiten. Wenn Sie auf einer ASCII-Maschine Änderungen durchführen, können Sie die resultierende EAR-Datei ohne EBCDIC-zu-ASCII-Konvertierung auf der z/OS- oder iSeries-Plattform implementieren und installieren.  

Erste Schritte

Installieren Sie WebSphere Application Server auf der gewünschten verteilten Plattform, und geben Sie an, dass die Beispielanwendungen von Application Server ebenfalls installiert werden sollen.

Legen Sie vor dem Ändern oder erneuten Erstellen der Beispiele eine Sicherungskopie des Verzeichnisses <Profilstammverzeichnis>/samples  an. Komprimieren Sie das Verzeichnis samples in einer ZIP-Datei. Durch Extrahieren der ZIP-Datei können Sie das Verzeichnis samples in seinem ursprünglichen Zustand wiederherstellen.

Verzeichnisstruktur

Die Beispiele sind in folgenden Verzeichnissen installiert:


<Profilstammverzeichnis>/samples/src/PlantsByWebSphere Enthält den Quellcode für das Beispiel Plants By WebSphere.
<Profilstammverzeichnis>/samples/lib/PlantsByWebSphere Enthält die WAR-Dateien (Web Archive), JAR-Dateien (Java Archive) und die Datei PlantsByWebSphere.ear für das Beispiel Plants By WebSphere. Das Verzeichnis bld wird nach der erneuten Erstellung des Beispiels "Plants by WebSphere" erstellt.
<Profilstammverzeichnis>/samples/javadoc/PlantsByWebSphere Enthält die Javadoc-Dokumentation. Das Verzeichnis bld wird nach der erneuten Erstellung des Beispiels "Plants by WebSphere" erstellt.
<Profilstammverzeichnis>/samples/bld/PlantsByWebSphere Enthält die generierten Klassendateien. Verwenden Sie diese Klassendateien, um die endgültige Datei PlantsByWebSphere.ear zu generieren. Das Verzeichnis bld wird nach der erneuten Erstellung des Beispiels "Plants by WebSphere" erstellt.

Beispiel erneut erstellen und installieren

Das Beispiel Plants By WebSphere wird zusammen mit WebSphere Application Server installiert. Sie müssen das Beispiel Plants By WebSphere nicht erneut erstellen, um es verwenden zu können. Die folgenden Anweisungen beschreiben, wie Sie die Beispiele erneut erstellen und gegebenenfalls Änderungen vornehmen.


Build-Script für die Beispiele ausführen
Erneut erstellte Datei PlantsByWebSphere.ear übertragen
Datei PlantsByWebSphere.ear entfernen und erneut installieren

Build-Script für die Beispiele ausführen

Wenn Sie dieses Beispiel erneut erstellen möchten, stellen Sie sicher, dass Profilstammverzeichnis/bin in Ihrer Umgebungsvariablen "PATH" enthalten ist. Gehen Sie wie folgt vor, um das Build-Script für die Beispiele auszuführen:

  1. Öffnen Sie eine Eingabeaufforderung.
  2. Wechseln Sie in der Befehlszeile in das Verzeichnis <Installationsstammverzeichnis>/samples/src/PlantsByWebSphere.
  3. Führen Sie das Build-Script für die Beispiele aus:

  4. Geben Sie den folgenden Befehl ein:


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


    • Geben Sie auf Windows-Plattformen den folgenden Befehl ein:

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


    • Geben Sie auf UNIX- und Linux-Entwicklungsplattformen den folgenden Befehl ein:

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

Damit ist der Build für das Beispiel erstellt.

Die Scripts buildplantsby.bat und buildplantsby.sh im Verzeichnis Profilstammverzeichnis/samples/bin/PlantsByWebSphere setzen die erforderlichen Klassenpfadinformationen und führen das Build-Dienstprogramm "Ant" aus. Ant liest die Dateien build.xml, die beschreiben, wie das Beispiel erstellt wird. Die ergänzende Dokumentation zu Ant finden Sie auf der Jakarta-Website.

Wichtige Information   Während des Build werden nur Klassendateien mit Änderungen neu erstellt. Die restlichen Klassendateien werden in die neue EAR-Datei gepackt.

Erneut erstellte Datei PlantsByWebSphere.ear übertragen

Führen Sie die folgenden Schritte durch, um die binäre EAR-Datei mit FTP (File Transfer Protocol) auf den z/OS- oder iSeries-Server zu übertragen.

  1. Die erneut erstellte EAR-Datei befindet sich im Verzeichnis <Profilstammverzeichnis>/samples/lib/PlantsByWebSphere.
  2. Öffnen Sie auf der Entwicklungsplattform eine FTP-Sitzung zu WebSphere Application Server für z/OS oder iSeries.
  3. Wechseln Sie in das Verzeichnis <Profilstammverzeichnis>/samples/lib/PlantsByWebSphere.
    Möglicherweise müssen Sie das Verzeichnis erstellen, wenn es noch nicht vorhanden ist.
  4. Wenn die Datei PlantsByWebSphere.ear vorhanden ist, löschen Sie sie, damit die aktualisierte Datei geschrieben werden kann.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

Datei PlantsByWebSphere.ear entfernen und erneut installieren

Standardmäßig wird das Beispiel "Plants by WebSphere" im Verzeichnis Profilstammverzeichnis/installedApps/<Zellenname> installiert, wobei <Zellenname> für den Namen der Zelle steht, in der Ihre Anwendung installiert wird. Gehen Sie zum erneuten Installieren des Beispiels wie folgt vor:

  1. Stoppen Sie den Anwendungsserver.
  2. Entfernen Sie wie folgt die EAR-Datei des WebSphere-Beispiels:
    1. Geben Sie die folgenden Befehle ein:

      cd <Profilstammverzeichnis>\bin
      setupCmdLine

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

      Auf z/OS-Plattformen:
      cd <Profilstammverzeichnis>/bin
      . ./setupCmdLine.sh

      Auf iSeries-Plattformen:
      cd <Profilstammverzeichnis>/bin
      . ./setupCmdLine

      <Profilstammverzeichnis> steht für das Installationsverzeichnis des Profils.
    2. Geben Sie den folgenden Befehl ein, um die Anwendung zu deinstallieren (Profilstammverzeichnis/bin muss in der Umgebungsvariablen "PATH" enthalten sein):

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

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

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

      Auf iSeries-Plattformen:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Gehen Sie wie folgt vor, um das Beispiel Plants by WebSphere erneut zu installieren:
    • Wechseln Sie in das Verzeichnis Profilstammverzeichnis/samples/lib/PlantsByWebSphere.
    • Suchen Sie die Datei PlantsByWebSphere.ear.
    • Geben Sie den folgenden Befehl ein:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<Knoten>', '-server', '<Server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <Knoten> steht für den Namen des Knotens und <Server> für den Namen des Servers, in dem Sie das Beispiel installieren möchten.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<Knoten>', '-server', '<Server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <Knoten> steht für den Namen des Knotens und <Server> für den Namen des Servers, in dem Sie das Beispiel installieren möchten.

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

      Auf iSeries-Plattformen:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<Knoten>', '-server', '<Server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <Knoten> steht für den Namen des Knotens und <Server> für den Namen des Servers, in dem Sie das Beispiel installieren möchten.
  4. Starten Sie den Anwendungsserver.

 

Die neu erstellte Datei PlantsByWebsphere.ear ist damit im Application Server implementiert.