Wenn Sie eine Client- oder Serveranwendung haben, verwenden Sie dieselben grundlegenden Schritte für die Ausführung der Anwendung in Apache Tomcat in Rational
Application Developer. Für eine Clientanwendung können Sie eine Webanwendung konfigurieren und ausführen, die einen
eXtreme-Scale-Client in Rational Application Developer verwendet. Folgen Sie diesen Anweisungen, um ein Webprojekt für die Ausführung eines
eXtreme-Scale-Servers oder -Containers zu erstellen.
Für eine Serveranwendung können Sie eine Java-EE-Anwendung in der Schnittstelle von Rational Application Developer
mit einer eigenständigen Installation von WebSphere eXtreme Scale aktivieren. Folgen Sie diesen Anweisungen, um ein
Java-EE-Anwendungsprojekt für die Verwendung der Clientbibliothek von WebSphere eXtreme Scale zu konfigurieren.
Vorbereitende Schritte
Installieren Sie die Testversion von
WebSphere eXtreme Scale oder das vollständige Produkt.
- Installieren Sie die eigenständige Version des Produkts WebSphere eXtreme Scale.
- Laden Sie die Testversion von WebSphere eXtreme Scale herunter, und entpacken Sie sie.
- Installieren Sie Apache Tomcat Version 6.0 oder höher.
- Installieren sie Rational Application
Developer, und erstellen Sie eine Java-EE-Webanwendung.
Vorgehensweise
- Fügen Sie die Laufzeitbibliothek von WebSphere eXtreme Scale Ihrem Java-EE-Build-Pfad hinzu.
Clientanwendung: In diesem Szenario können Sie eine Webanwendung konfigurieren und ausführen, die einen eXtreme-Scale-Client in
Rational Application Developer verwendet.
- Klicken Sie auf . Klicken Sie auf
Neu.
- Geben Sie eXtremeScaleClient als Benutzerbibliotheksnamen ein, und klicken Sie auf
OK.
- Klicken Sie auf JARs hinzufügen.... Navigieren Sie zur Datei
WXS-Ausgangsverzeichnis/lib/ogclient.jar, und wählen Sie diese aus.
Klicken Sie auf Öffnen.
- Optional: (Optional) Zum Hinzufügen von Javadoc wählen Sie die die Javadoc-Position aus, und klicken Sie anschließend auf
Bearbeiten.... Sie können im Feld "Javadoc-Verzeichnispfad" den URL der API-Dokumentation eingeben, oder Sie können die API-Dokumentation
herunterladen.
- Wenn Sie die online verfügbare API-Dokumentation verwenden möchten, geben Sie
http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ im Feld "Javadoc-Verzeichnispfad" ein.
- Wenn Sie die API-Dokumentation herunterladen möchten, rufen Sie die
Downloadseite für die API-Dokumentation zu WebSphere eXtreme Scale ein. Geben Sie
als Javadoc-Verzeichnispfad das lokale Downloadverzeichnis ein.
- Klicken Sie auf OK.
- Klicken Sie auf OK, um den Dialog "Benutzerbibliotheken" zu schließen.
- Klicken Sie auf .
- Klicken Sie auf Java-Erstellungspfad.
- Klicken Sie auf Bibliothek hinzufügen.
- Wählen Sie Benutzerbibliothek aus. Klicken Sie auf Weiter.
- Wählen Sie die Bibliothek eXtremeScaleClient aus, und klicken Sie auf
Fertig stellen.
- Klicken Sie auf OK, um den Dialog
Projekteigenschaften zu schließen.
Serveranwendung: In diesem Szenario möchten Sie eine
Webanwendung für die Ausführung eines integrierten eXtreme-Scale-Servers in Rational
Application Developer konfigurieren und ausführen.
- Klicken Sie auf .
Klicken Sie auf
Neu.
- Geben Sie eXtremeScale als Benutzerbibliotheksnamen ein, und klicken Sie auf
OK.
- Klicken Sie auf JARs hinzufügen..., und wählen Sie WXS-Ausgangsverzeichnis/lib/objectgrid.jar aus.
Klicken Sie auf "Öffnen".
- (Optional) Zum Hinzufügen von Javadoc wählen Sie die die Javadoc-Position aus, und klicken Sie anschließend auf
Bearbeiten.... Geben Sie im Feld "Javadoc-Verzeichnispfad" http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ ein.
- Klicken Sie auf OK.
- Klicken Sie auf OK, um den Dialog "Benutzerbibliotheken" zu schließen.
- Klicken Sie auf .
- Klicken Sie auf Java-Erstellungspfad.
- Klicken Sie auf Bibliothek hinzufügen.
- Wählen Sie Benutzerbibliothek aus. Klicken Sie auf Weiter.
- Wählen Sie die Bibliothek eXtremeScaleClient aus, und klicken Sie auf
Fertig stellen.
- Klicken Sie auf OK, um den Dialog
Projekteigenschaften zu schließen.
- Definieren Sie den Tomcat-Server für Ihr Projekt.
- Vergewissern Sie sich, dass Sie sich in der J2EE-Perspektive befinden, und klicken Sie anschließend im unteren
Teilfenster auf das Register Server.
Sie können auch auf klicken.
- Klicken Sie mit der rechten Maustaste in das Teilfenster "Server", und wählen Sie
aus.
- Wählen Sie Apache, Tomcat v6.0 Server aus.
Klicken Sie auf Weiter.
- Klicken Sie auf Durchsuchen...
Wählen Sie Tomcat-Stammverzeichnis aus.
Klicken Sie auf OK.
- Klicken Sie auf Weiter.
- Wählen Sie im linken Teilfenster "Verfügbar" Ihre Java-EE-Anwendung aus, und klicken Sie auf
Hinzufügen >, um die Anwendung in das rechte Teilfenster "Konfiguriert"
zu verschieben. Klicken Sie anschließend auf Fertig stellen.
- Beheben Sie alle verbleibenden Fehler für das Projekt. Verwenden Sie die folgenden Schritte, um Fehler im Teilfenster "Probleme" zu beheben:
- Klicken Sie auf . Klicken Sie auf OK.
Erstellen Sie das Projekt.
- Klicken Sie mit der rechten Maustaste auf das Java-EE-Projekt, und wählen Sie
aus.
- Klicken Sie auf das Register Bibliotheken. Stellen Sie sicher, dass der Pfad ordnungsgemäß konfiguriert ist:
- Für Clientanwendungen: Stellen Sie sicher, dass Apache Tomcat, eXtremeScaleClient und
Java 1.5 JRE im Pfad enthalten sind.
- Für Serveranwendungen: Stellen Sie sicher, dass Apache Tomcat,
eXtremeScale und
Java 1.5 JRE im Pfad enthalten sind.
- Erstellen Sie eine Ausführungskonfiguration für die Ausführung Ihrer Anwendung.
- Wählen Sie im Menü Ausführen die Option
Ausführungskonfigurationen aus.
- Klicken Sie mit der rechten Maustaste auf die Kategorie "Java-Anwendung", und wählen Sie
Neu aus.
- Wählen Sie die neue Ausführungskonfiguration mit dem Namen neue_Konfiguration aus.
- Konfigurieren Sie das Profil.
- Projekt (auf der Hauptregisterkarte): Name_Ihres_Projekts
- Hauptklasse (auf der Hauptregisterkarte): Name_Ihrer_Hauptklasse
- VM-Argumente (auf der Registerkarte "Argumente"): -Djava.endorsed.dirs=WXS-Stammverzeichnis/lib/endorsed
Probleme mit den VM-Argumenten treten häufig auf, weil der Pfad von
java.endorsed.dirs ein absoluter Pfad ohne Variablen oder Direktaufrufe sein muss.
Weitere häufig auftretende Setup-Probleme beziehen sich auf den Object Request Broker (ORB). Der folgende Fehler könnte angezeigt werden.
Weitere Informationen finden Sie im Abschnitt
Angepassten Object Request Broker konfigurieren:
Caused by: java.lang.RuntimeException: The ORB that comes with the
Java implementation does not work with ObjectGrid at this time.
Wenn die Datei
objectGrid.xml oder
deployment.xml für die Anwendung nicht zugänglich ist, kann der folgende Fehler ausgegeben werden:
Exception in thread "P=211046:O=0:CT" com.ibm.websphere.objectgrid.ObjectGridRuntimeException:
Cannot start OG container
at Client.startTestServer(Client.java:161)
at Client.main(Client.java:82)
Caused by: java.lang.IllegalArgumentException: The objectGridXML must not be null
at com.ibm.websphere.objectgrid.deployment.DeploymentPolicyFactory.createDeploymentPolicy
(DeploymentPolicyFactory.java:55)
at Client.startTestServer(Client.java:154)
... 1 more
- Klicken Sie auf Anwenden, und schließen Sie das Fenster, oder klicken Sie auf
Ausführen.
Nächste Schritte
Nach der Konfiguration und Ausführung einer Webanwendung mit
einem Client von WebSphere eXtreme Scale in Rational Application Developer können Sie ein Servlet entwickeln.
Dieses Servlet verwendet APIs von WebSphere eXtreme Scale, um Daten aus einem fernen
Datengrid zu speichern und abzurufen.
Nachdem Sie eine Java-EE-Anwendung in der Schnittstelle von Rational Application Developer
mit einer eigenständigen Installation von WebSphere eXtreme Scale aktiviert haben, können Sie
ein Servlet entwickeln, das die System-APIs von WebSphere eXtreme Scale verwendet, um Katalogservices zu starten und zu stoppen.