REST-Datenservice in WebSphere Application Server implementieren

In diesem Abschnitt wird beschrieben, wie Sie den REST-Datenservice von WebSphere eXtreme Scale in WebSphere Application Server oder WebSphere Application Server Network Deployment Version 6.1.0.25 oder höher konfigurieren. Diese Anweisungen gelten auch für Implementierungen, in denen WebSphere eXtreme Scale mit der Implementierung von WebSphere Application Server integriert ist.

Vorbereitende Schritte

Sie müssen eine der folgenden Umgebungen auf Ihrem System haben, um den REST-Datenservice für WebSphere eXtreme Scale zu konfigurieren und zu implementieren.

Vorgehensweise

  1. Konfigurieren und starten Sie ein Datengrid.
    1. Einzelheiten zum Konfigurieren eines Datengrids für den REST-Datenservice finden Sie unter Datengrid für REST-Datenservices in WebSphere Application Server starten.
    2. Vergewissern Sie sich, dass ein Client eine Verbindung zum Grid herstellen und auf die Entitäten im Datengrid zugreifen kann. Ein Beispiel finden Sie unter Lernprogramm: Einführung in WebSphere eXtreme Scale.
  2. Erstellen Sie die Konfigurations-JAR-Datei oder das Konfigurationsverzeichnis für den REST-Datenservice von eXtreme Scale. Informationen zum Packen und Implementieren des REST-Service finden Sie unter REST-Datenservice installieren.
  3. Fügen Sie die Konfigurations-JAR-Datei bzw. das Konfigurationsverzeichnis für den REST-Datenservice dem Klassenpfad des Anwendungsservers hinzu:
    1. Öffnen Sie die Administrationskonsole von WebSphere Application Server.
    2. Navigieren Sie zu Umgebung > Gemeinsam genutzte Bibliotheken.
    3. Klicken Sie auf Neu.
    4. Fügen Sie den entsprechenden Feldern die folgenden Einträge hinzu:
      • Name: extremescale_rest_configuration
      • Klassenpfad: <Konfigurations-JAR oder -Verzeichnis für REST-Service>
    5. Klicken Sie auf OK.
    6. Speichern Sie die Änderungen in der Masterkonfiguration.
  4. Fügen Sie die JAR-Datei für die eXtreme-Scale-Clientlaufzeitumgebung, die Datei wsogclient.jar und die Konfigurations-JAR-Datei bzw. das Konfigurationsverzeichnis für den REST-Datenservice dem Klassenpfad des Anwendungsservers hinzu. Dieser Schritt ist nicht erforderlich, wenn WebSphere eXtreme Scale mit der Installation von WebSphere Application Server integriert ist.

    1. Öffnen Sie die Administrationskonsole von WebSphere Application Server.
    2. Navigieren Sie zu Umgebung > Gemeinsam genutzte Bibliotheken.
    3. Klicken Sie auf Neu.
    4. Fügen Sie den Feldern die folgenden Einträge hinzu:
      • Name: extremescale_client_v71
      • Klassenpfad: WXS-Ausgangsverzeichnis/lib/wsogclient.jar
      Hinweis: Fügen Sie jeden Pfad in einer gesonderten Zeile hinzu.
    5. Klicken Sie auf OK.
    6. Speichern Sie die Änderungen in der Masterkonfiguration.
  5. Installieren Sie die EAR-Datei des REST-Datenservice wxsrestservice.ear über die Administrationskonsole in WebSphere Application Server:
    1. Öffnen Sie die Administrationskonsole von WebSphere Application Server.
    2. Klicken Sie auf Anwendungen > Neue Anwendung.
    3. Navigieren Sie zur Datei /lib/wxsrestservice.ear im Dateisystem, wählen Sie sie aus, und klicken Sie auf Weiter.
      • Wenn Sie WebSphere Application Server Version 7.0 verwenden, klicken Sie auf "Weiter".
      • Wenn Sie WebSphere Application Server Version 6.1 verwenden, geben Sie einen Kontextstammwert mit dem Namen /wxsrestservice ein, und fahren Sie mit dem nächsten Schritt fort.
    4. Wählen Sie die Option für detaillierte Installation aus, und klicken Sie auf Weiter.
    5. Klicken Sie in der Anzeige mit Anwendungssicherheitswarnungen auf Weiter.
    6. Wählen Sie die Standardinstallationsoptionen aus, und klicken Sie auf Weiter.
    7. Wählen Sie einen Server aus, dem Sie die Anwendung zuordnen möchten, und klicken Sie auf Weiter.
    8. Verwenden Sie auf der Seite für das erneute Laden von JSP-Dateien die Standardeinstellungen, und klicken Sie auf Weiter.
    9. Ordnen Sie auf der Seite "Gemeinsam genutzte Bibliotheken" das Modul wxsrestservice.war den definierten gemeinsam benutzten Bibliotheken zu:
      • extremescale_rest_configuration
      • extremescale_client_v71
      Tipp: Diese gemeinsam genutzte Bibliothek ist nur erforderlich, wenn WebSphere eXtreme Scale nicht mit WebSphere Application Server integriert ist.
    10. Verwenden Sie auf der Seite für die Zuordnung von Beziehungen zu gemeinsam genutzten Bibliotheken die Standardeinstellungen, und klicken Sie auf Weiter.
    11. Verwenden Sie auf der Seite für die Zuordnung virtueller Hosts die Standardeinstellungen, und klicken Sie auf Weiter.
    12. Setzen Sie auf der Seite für die Zuordnung der Kontextstammelemente das Kontextstammelement auf "wxsrestservice".
    13. Klicken Sie in der Anzeige "Zusammenfassung" auf Fertig stellen, um die Installation durchzuführen.
    14. Speichern Sie die Änderungen in der Masterkonfiguration.
  6. Starten Sie die REST-Datenserviceanwendung wxsrestservice.
    1. Wechseln Sie in der Administrationskonsole zu der Anwendung.
      • WebSphere Application Server Version 7.0: Klicken Sie in der Administrationskonsole auf Anwendungen > Anwendungstypen > WebSphere-Anwendungen.
      • WebSphere Application Server Version 6.1: Klicken Sie in der Administrationskonsole auf Anwendungen > Enterprise-Anwendungen.
    2. Wählen Sie das Kontrollkästchen neben der Anwendung wxsrestservice aus, und klicken Sie auf Starten.
    3. Sehen Sie sich die Datei SystemOut.log für das Anwendungsserverprofil an. Wenn der REST-Datenservice erfolgreich gestartet wurde, wird die folgende Nachricht in der Datei SystemOut.log für das Serverprofil angezeigt:

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

  7. Vergewissern Sie sich, dass der REST-Datenservice funktioniert: Die Portnummer finden Sie, indem Sie in der Datei SystemOut.log im Verzeichnis "logs" des Anwendungsserverprofils nach dem ersten Port suchen, der für die Nachrichten-ID SRVE0250I angezeigt wird. Der Standardport ist 9080.

    Beispiel: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/ Das AtomPub-Servicedokument wird angezeigt.

    Beispiel: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata. Das EDMX-Dokument (Entity Model Data Extensions) wird angezeigt.

  8. Zum Stoppen der Datengridprozesse verwenden Sie die Tastenkombination STRG+C im entsprechenden Befehlsfenster.