REST-Datenservices in Apache Tomcat starten

In diesem Abschnitt wird beschrieben, wie der REST-Datenservice von eXtreme Scale mit Apache Tomcat Version 5.5 oder höher konfiguriert und gestartet wird.

Vorbereitende Schritte

Vergewissern Sie sich, dass das eXtreme-Scale-Beispieldatengrid gestartet ist. Einzelheiten zum Starten des Datengrids finden Sie unter REST-Datenservice aktivieren.

Vorgehensweise

  1. Laden Sie Apache Tomcat Version 5.5 oder höher in das Tomcat-Installationsverzeichnis herunter, und installieren Sie diese Version. Beispiel: /opt/tomcat
  2. Installieren Sie den REST-Datenservice von eXtreme Scale und das bereitgestellte Beispiel wie folgt im Tomcat-Server:
    1. Wenn Sie eine Oracle JRE oder ein Oracle JDK verwenden, müssen Sie den IBM® ORB in Tomcat installieren:
      • Für Tomcat Version 5.5

        Kopieren Sie alle JAR-Dateien von

        WXS-Ausgangsverzeichnis/lib/endorsed

        nach

        Tomcat-Stammverzeichnis/common/endorsed

      • Für Tomcat Version 6.0
        1. Erstellen Sie ein Verzeichnis "endorsed".
          • [Unix][Linux] mkdir Tomcat-Stammverzeichnis/endorsed
          • [Windows] md Tomcat-Stammverzeichnis/endorsed
        2. Kopieren Sie alle JAR-Dateien von

          WXS-Ausgangsverzeichnis/lib/endorsed

          nach

          Tomcat-Stammverzeichnis/endorsed

    2. Implementieren Sie das REST-Datenservicemodul "wxsrestservice.war" im Tomcat-Server.

      Kopieren Sie die Datei "wxsrestservice.war" von

      Ausgangsverzeichnis_des_REST-Service/lib

      nach

      Tomcat-Stammverzeichnis/webapps

    3. Fügen Sie die JAR-Datei für die ObjectGrid-Clientlaufzeitumgebung und die Anwendungs-JAR-Datei dem gemeinsam genutzten Klassenpfad in Tomcat hinzu:
      1. Bearbeiten Sie die Datei Tomcat-Stammverzeichnis/conf/catalina.properties.
      2. Fügen Sie die folgenden Pfadnamen am Ende der Eigenschaft "shared.loader" in Form einer durch Kommas begrenzten Liste hinzu:
        • WXS-Ausgangsverzeichnis/lib/ogclient.jar
        • Ausgangsverzeichnis_des_REST-Service/gettingstarted/restclient/bin
        • Ausgangsverzeichnis_des_REST-Service/gettingstarted/common/bin
        Wichtig: Das Pfadtrennzeichen muss ein Schrägstrich sein.

  3. Wenn das eXtreme-Scale-Datengrid mit aktivierter eXtreme-Scale-Sicherheit gestartet wurde, setzen Sie die folgenden Eigenschaften in der Datei Ausgangsverzeichnis_des_REST-Service/gettingstarted/restclient/bin/wxsRestService.properties.
    ogClientPropertyFile=Ausgangsverzeichnis_des_REST-Service/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. Starten Sie den Tomcat-Server mit dem REST-Datenservice:
    • Wenn Sie Tomcat 5.5 unter UNIX or Windows oder Tomcat 6.0 unter UNIX verwenden, gehen Sie wie folgt vor:
      1. cd Tomcat-Stammverzeichnis/bin
      2. Starten Sie den Server:
        • [Unix][Linux] ./catalina.sh run
        • [Windows] catalina.bat run
      3. In der Konsole werden daraufhin die Apache-Tomcat-Protokolle angezeigt. Wenn der REST-Datenservice erfolgreich gestartet wurde, wird die folgende Nachricht in der Administrationskonsole angezeigt:

        CWOBJ4000I: Der REST-Datenservice von WebSphere eXtreme Scale wurde gestartet.

    • Wenn Sie Tomcat 6.0 unter Windows verwenden, gehen Sie wie folgt vor:
      1. cd Tomcat-Stammverzeichnis/bin
      2. Starten Sie das Konfigurationstool von Apache Tomcat 6 mit dem folgenden Befehl: tomcat6w.exe
      3. Klicken Sie im Eigenschaftsfenster von Apache Tomcat 6 auf die Startschaltfläche, um den Tomcat-Server zu starten.
      4. Sehen Sie sich die folgenden Protokolle an, um sich zu vergewissern, dass der Tomcat-Server erfolgreich gestartet wurde:
        • Tomcat-Stammverzeichnis/bin/catalina.log

          Zeigt den Status der Tomcat-Server-Engine an.

        • Tomcat-Stammverzeichnis/bin/stdout.log

          Zeigt das Systemausgabeprotokoll an.

      5. Wenn der REST-Datenservice erfolgreich gestartet wurde, wird die folgende Nachricht im Systemausgabeprotokoll angezeigt: CWOBJ4000I: Der REST-Service von WebSphere eXtreme Scale wurde gestartet.
  5. Vergewissern Sie sich, dass der REST-Datenservice funktioniert:
    1. Öffnen Sie einen Browser, und navigieren Sie zur folgenden Adresse:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid

      Das Servicedokument für das Grid NorthwindGrid wird angezeigt.

    2. Navigieren Sie zur folgenden Adresse:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      Das EDMX-Dokument (Entity Model Data Extensions) wird angezeigt.

  6. Zum Stoppen der Datengridprozesse verwenden Sie die Tastenkombination STRG+C im entsprechenden Befehlsfenster.
  7. Zum Stoppen von Tomcat verwenden Sie die Tastenkombination STRG+C in dem Fenster, in dem Sie Tomcat gestartet haben.