REST-Datenservice in Apache Tomcat implementieren

In diesem Artikel wird beschrieben, wie Sie den REST-Datenservice von WebSphere eXtreme Scale in Apache Tomcat Version 5.5 oder höher konfigurieren.

Informationen zu diesem Vorgang

Vorgehensweise

  1. Wenn Sie eine Oracle JRE oder ein Oracle JDK verwenden, installieren Sie IBM ORB in Tomcat:
    1. Tomcat Version 5.5:

      Kopieren Sie alle JAR-Dateien aus dem

      Verzeichnis WXS-Ausgangsverzeichnis/lib/endorsed

      in das

      Verzeichnis Tomcat-Stammverzeichnis/common/endorsed.

    2. Tomcat Version 6.0:

      Erstellen Sie ein Verzeichnis "endorsed":

      [Unix][Linux] mkdir Tomcat-Stammverzeichnis/endorsed

      [Windows] md Tomcat-Stammverzeichnis/endorsed

      Kopieren Sie alle JAR-Dateien aus dem

      Verzeichnis wxs_home/lib/endorsed

      in das

      Verzeichnis tomcat_root/common/endorsed.

  2. Konfigurieren und starten Sie das Datengrid.
    1. Einzelheiten zum Konfigurieren eines Datengrids für den REST-Datenservice finden Sie in Konfigurieren.
    2. Vergewissern Sie sich, dass ein eXtreme-Scale-Client eine Verbindung zum Grid herstellen und auf die Entitäten im Grid zugreifen kann. Ein Beispiel finden Sie unter REST-Datenservices konfigurieren.
  3. Erstellen Sie die Konfigurations-JAR-Datei oder das Konfigurationsverzeichnis für den REST-Datenservice von eXtreme Scale. Einzelheiten finden Sie in den Informationen zum Packen und Implementieren unter REST-Datenservice installieren.
  4. 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

  5. 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" hinzu, indem Sie die einzelnen Pfadnamen durch Kommas trennen:
  6. Wenn Sie die Java-2-Sicherheit verwenden, fügen Sie der Tomcat-Richtliniendatei Sicherheitsberechtigungen hinzu:
  7. Starten Sie den Tomcat-Server:
    • Bei der Verwendung von Tomcat 5.5 unter UNIX oder Windows oder der Verwendung von Tomcat 6.0 durch Verteilung über eine ZIP-Datei

      1. cd Tomcat-Stammverzeichnis/bin
      2. Starten Sie den Server:
        • Ohne aktivierte Java-2-Sicherheit:

          [Unix][Linux] ./catalina.sh run

          [Windows] catalina.bat run

        • Mit aktivierter Java-2-Sicherheit:

          [Unix][Linux] ./catalina.sh run -security

          [Windows] catalina.bat run -security

      3. Die Apache-Tomcat-Protokolle werden in der Konsole 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.

    • Bei der Verwendung von Tomcat 6.0 unter Windows über Verteilung durch das Windows-Installationsprogramm:
      1. cd /bin
      2. Starten Sie das Konfigurationstool von Apache Tomcat 6:

        tomcat6w.exe

      3. Java-2-Sicherheit aktivieren (optional):

        Fügen Sie den Java-Optionen auf der Registerkarte "Java" im Eigenschaftsfenster von Apache Tomcat 6 die folgenden Einträge hinzu:

        -Djava.security.manager

        -Djava.security.policy=\conf\catalina.policy

      4. Klicken Sie im Eigenschaftsfenster von Apache Tomcat 6 auf die Startschaltfläche, um den Tomcat-Server zu starten.
      5. Sehen Sie sich die folgenden Protokolle an, um sich zu vergewissern, dass der Tomcat-Server erfolgreich gestartet wurde:
      6. Wenn der REST-Datenservice erfolgreich gestartet wurde, wird die folgende Nachricht im Systemausgabeprotokoll angezeigt:

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

  8. Vergewissern Sie sich, dass der REST-Datenservice funktioniert.
    Öffnen Sie einen Webbrowser, und navigieren Sie zum folgenden URL:
    http://Host:Port/Kontextstammelement/restservice/Gridname

    Der Standardport für Tomcat ist 8080 und wird in der Datei Tomcat-Stammverzeichnis/conf/server.xml im Element <Connector> definiert.

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

Ergebnisse

Das Dokument des AtomPub-Service wird angezeigt.