Beispiel BeenThere 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-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-Systemen installieren.

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

Jeder Kunde, der WebSphere Application Server (Application Server) für z/OS 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-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 des Beispiels eine Sicherungskopie des Verzeichnisses <Profilstammverzeichnis> 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 erstellte Verzeichnisstruktur für das Beispiel lautet wie folgt:


Profilstammverzeichnis/samples/src/BeenThere Enthält den Quellcode für das Beispiel BeenThere.
Profilstammverzeichnis/samples/lib/BeenThere Enthält die Datei BeenThere.ear für das Beispiel BeenThere.
Profilstammverzeichnis/samples/javadoc/BeenThere Enthält die Javadoc-Dokumentation, die beim Erstellen des Beispiels BeenThere generiert wird.
Profilstammverzeichnis/samples/bld/BeenThere Enthält die generierten Klassendateien. Verwenden Sie diese Klassendateien, um die endgültige Datei BeenThere.ear zu generieren. Nach dem erneuten Erstellen des Beispiels BeenThere wird das Verzeichnis bld angelegt.



Beispiel erneut erstellen und installieren

Die folgenden Anweisungen beschreiben die zum erneuten Erstellen des Beispiels auszuführenden Schritte.


Build-Script für die Beispiele ausführen

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 Profilstammverzeichnis/samples/src/BeenThere.
  3. Führen Sie das Build-Script für die Beispiele aus:

  4. Geben Sie den folgenden Befehl ein:

    Profilstammverzeichnis\samples\bin\BeenThere\buildBeenThere.bat

    Geben Sie den folgenden Befehl ein:

    . Profilstammverzeichnis/samples/bin/BeenThere/buildBeenThere.sh

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

      Profilstammverzeichnis\samples\bin\BeenThere\buildBeenThere.bat

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

      . Profilstammverzeichnis/samples/bin/BeenThere/buildBeenThere.sh
    Geben Sie den folgenden Befehl ein:

    . Profilstammverzeichnis/samples/bin/BeenThere/buildBeenThere.sh

Damit ist der Build für das Beispiel erstellt.

Sie finden das Script buildBeenThere.bat bzw. buildBeenThere.sh im Verzeichnis Profilstammverzeichnis/samples/bin/BeenThere. Diese Scripts setzen den richtigen Klassenpfad und führen das Build-Dienstprogramm Ant aus. Das Dienstprogramm Ant liest die Dateien build.xml, die beschreiben, wie die Beispiele zu erstellen sind. Die ergänzende Dokumentation zu Ant finden Sie auf der Jakarta-Website.

Erneut erstellte Datei BeenThere.ear übertragen

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

  1. Die erneut erstellte EAR-Datei befindet sich im Verzeichnis <Profilstammverzeichnis>/samples/lib/BeenThere.
  2. Öffnen Sie auf der Entwicklungsplattform eine FTP-Sitzung zu WebSphere Application Server für z/OS.
  3. Wechseln Sie in das Verzeichnis <Profilstammverzeichnis>/samples/lib/BeenThere.
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Datei BeenThere.ear entfernen und erneut installieren

Gehen Sie zum erneuten Installieren des Beispiels wie folgt vor:


  1. Starten Sie die Administrationskonsole, indem Sie in einem Webbrowser die Adresse http://<Hostname>:9060/ibm/console eingeben. <Hostname> steht für den Hostnamen oder die IP-Adresse, unter dem bzw. der der Deployment Manager ausgeführt wird.
  2. Starten Sie die Administrationskonsole, indem Sie in einem Webbrowser die Adresse http://<Hostname>:9060/ibm/console eingeben. <Hostname> steht für den Hostnamen oder die IP-Adresse, unter dem bzw. der der Deployment Manager ausgeführt wird.
  3. Starten Sie die Administrationskonsole, indem Sie in einem Webbrowser die Adresse http://<Hostname>:9080/admin eingeben. <Hostname> steht für den Hostnamen oder die IP-Adresse, unter dem bzw. der der Deployment Manager ausgeführt wird.
  4. Starten Sie die Administrationskonsole, indem Sie in einem Webbrowser die Adresse http://<Hostname>:9060/ibm/console eingeben. <Hostname> steht für den Hostnamen oder die IP-Adresse, unter dem bzw. der der Deployment Manager ausgeführt wird.
  5. Klicken Sie auf Server > Cluster.
  6. Wählen Sie alle Cluster aus.
  7. Klicken Sie auf Stoppen.
  8. Klicken Sie auf Anwendungen > Enterprise-Anwendungen.
  9. Wählen Sie die Anwendung BeenThere aus.
  10. Klicken Sie auf Deinstallieren.
  11. Klicken Sie oben in der Hauptanzeige der Administrationskonsole auf Speichern.
  12. Klicken Sie auf Speichern.
  13. Führen Sie die Schritte zum Installieren der Datei BeenThere.ear aus.

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