REST-Datenservice in WebSphere Application Server Community Edition starten

In diesem Abschnitt wird beschrieben, wie der REST-Datenservice von eXtreme Scale mit WebSphere Application Server Community Edition konfiguriert und gestartet wird.

Vorbereitende Schritte

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

Vorgehensweise

  1. Laden Sie WebSphere Application Server Community Edition Version 2.1.1.3 oder höher herunter, und installieren Sie das Produkt im WASCE-Stammverzeichnis, z. B. /opt/IBM/wasce.
  2. Starten Sie den Server von WebSphere Application Server Community Edition mit dem folgenden Befehl:
    • [Linux][Unix] WASCE-Stammverzeichnis/bin/startup.sh
    • [Windows] WASCE-Stammverzeichnis/bin/startup.bat

  3. Wenn das eXtreme-Scale-Grid 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. Installieren Sie den REST-Datenservice von eXtreme Scale und das bereitgestellte Beispiel im Server von WebSphere Application Server Community Edition:
    1. Fügen Sie die JAR-Datei für die ObjectGrid-Clientlaufzeitumgebung dem Repository von WebSphere Application Server Community Edition hinzu:
      1. Öffnen Sie die Administrationskonsole von WebSphere Application Server Community Edition, und melden Sie sich an.
        Tipp: Der Standard-URL ist http://localhost:8080/console. Die Standardbenutzer-ID ist system, und das Kennwort ist manager.
      2. Klicken Sie im Ordner "Services" auf Repository.
      3. Tragen Sie im Abschnitt Archiv dem Repository hinzufügen Folgendes in die Eingabetextfelder ein:
        Tabelle 1. Archivierung im Repository
        Textfeld Wert
        Datei WXS-Ausgangsverzeichnis/lib/ogclient.jar
        Gruppe com.ibm.websphere.xs
        Artefakt ogclient
        Version 7.0
        Typ jar
      4. Klicken Sie auf die Schaltfläche "Installieren".
        Tipp: Suchen Sie im folgenden technischen Hinweis nach Einzelheiten zu den verschiedenen Methoden von Konfigurationsklassen- und Bibliotheksabhängigkeiten: Specifying external dependencies to applications running on WebSphere Application Server Community Edition.
    2. Implementieren Sie das Modul des REST-Datenservice, das in der Datei wxsrestservice.war enthalten ist, im Server von WebSphere Application Server Community Edition.
      1. Bearbeiten Sie die XML-Beispielimplementierungsdatei Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo-web.xml, und fügen Sie den Klassenpfadverzeichnissen für das Einführungsmuster Pfadabhängigkeiten hinzu.
        Ändern Sie die classesDirs-Pfade für die beiden GBeans des GettingStarted-Clients:
        • Der classesDirs-Pfad für die GBean "GettingStarted_Client_SharedLib" muss auf Ausgangsverzeichnis_des_REST-Service/Ggettingstarted/restclient/bin gesetzt werden.
        • Der classesDirs-Pfad für die GBean "GettingStarted_Common_SharedLib" muss auf Ausgangsverzeichnis_des_REST-Service/gettingstarted/common/bin gesetzt werden.

      2. Öffnen Sie die Administrationskonsole von WebSphere Application Server Community Edition, und melden Sie sich an.
        Tipp: Der Standard-URL ist http://localhost:8080/console. Die Standardbenutzer-ID ist system, und das Kennwort ist manager.
      3. Klicken Sie auf Neu implementieren.
      4. Geben Sie auf der Seite Neue Anwendungen installieren die folgenden Werte in die Textfelder ein:
        Tabelle 2. Installationswerte
        Textfeld Wert
        Archiv Ausgangsverzeichnis_des_REST-Service/lib/wxsrestservice.war
        Plan Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo-web.xml
      5. Klicken Sie auf die Schaltfläche "Installieren".

        Auf der Konsolseite sollte angezeigt werden, dass die Anwendung erfolgreich installiert und gestartet werden.

      6. Überprüfen Sie anhand des Systemausgabeprotokolls von WebSphere Application Server Community Edition oder der Konsole, ob der REST-Datenservice erfolgreich gestartet wurde, indem Sie nach der folgenden Nachricht suchen:

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

  5. Vergewissern Sie sich, dass der REST-Datenservice funktioniert:
    1. Öffnen Sie den folgenden Link in einem Browserfenster: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid. Das Servicedokument für das Grid "NorthwindGrid" wird angezeigt.
    2. Öffnen Sie den folgenden Link in einem Browserfenster: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata. Das EDMX-Dokument (Entity Model Data Extensions) wird angezeigt.
  6. Zum Stoppen der Gridprozesse verwenden Sie die Tastenkombination STRG+C im entsprechenden Befehlsfenster.
  7. Verwenden Sie zum Stoppen von WebSphere Application Server Community Edition den folgenden Befehl:
    • [Unix][Linux] WASCE-Stammverzeichnis/bin/shutdown.sh
    • [Windows] WASCE-Stammverzeichnis\bin\shutdown.bat
    Tipp: Die Standardbenutzer-ID ist system, und das Kennwort ist manager. Wenn Sie einen angepassten Port verwenden, verwenden Sie die Option -port.