REST-Datenservice in WebSphere Application Server Community Edition implementieren

Sie können den REST-Datenservice von eXtreme Scale in WebSphere Application Server Community Edition Version 2.1.1.3 oder höher konfigurieren.

Vorbereitende Schritte

Vorgehensweise

  1. Datengrid konfigurieren und starten.
    1. Einzelheiten zum Konfigurieren eines Datengrids von eXtreme Scale für den REST-Datenservice finden Sie unter Eigenständiges Datengrid für REST-Datenservices starten.
    2. Vergewissern Sie sich, dass ein eXtreme-Scale-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. Einzelheiten finden Sie in den Informationen zum Packen und Implementieren im Abschnitt REST-Datenservice installieren.
  3. Starten Sie den Server von WebSphere Application Server Community Edition:
    1. Führen Sie den folgenden Befehl aus, um den Server ohne aktivierte Java-SE-Sicherheit zu starten:

      [Unix][Linux] WASCE-Stammverzeichnis/bin/startup.sh

      [Windows] WASCE-Stammverzeichnis/bin/startup.bat

    2. Führen Sie die folgenden Schritte aus, um den Server mit aktivierter Java-SE-Sicherheit zu starten: [Unix][Linux]
      1. Öffnen Sie eine Befehlszeile oder ein Terminalfenster, und führen Sie den folgenden Kopierbefehl aus (oder kopieren Sie den Inhalt der angegebenen Richtliniendatei in Ihre vorhandene Richtlinie): cp Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo.policy WASCE-Stammverzeichnis/bin).
      2. Bearbeiten Sie die Datei wasce_root/bin/setenv.sh.
      3. Fügen Sie hinter der Zeile mit "WASCE_JAVA_HOME=" Folgendes hinzu: export JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy".

      [Windows]
      1. Öffnen Sie ein Befehlszeilenfenster, und führen Sie den folgenden Kopierbefehl aus, oder kopieren Sie den Inhalt der angegebenen Richtliniendatei in Ihre vorhandene Richtlinie:

        copy Ausgangsverzeichnis_des_REST-Service\gettingstarted\wasce\geronimo.policy\bin

      2. Bearbeiten Sie die Datei wasce_root\bin\setenv.bat.
      3. Fügen Sie hinter der Zeile mit "set WASCE_JAVA_HOME=" Folgendes hinzu:

        set JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

  4. 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. 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 der linken Seite des Konsolfensters auf den Link Repository.
    3. Tragen Sie im Abschnitt Archiv dem Repository hinzufügen Folgendes in die Eingabetextfelder ein:
      Tabelle 1. Archiv dem Repository hinzufügen
      Textfeld Wert
      Datei WXS-Ausgangsverzeichnis/lib/ogclient.jar
      Gruppe com.ibm.websphere.xs
      Artefakt ogclient
      Version 7.1
      Typ JAR
    4. Klicken Sie auf die Schaltfläche "Installieren".

    Suchen Sie im folgenden technischen Hinweis nach Einzelheiten zu den verschiedenen Methoden für die Konfiguration von Klassen- und Bibliotheksabhängigkeiten: Specifying external dependencies to applications running on WebSphere Application Server Community Edition.

  5. Implementieren Sie das Modul des REST-Datenservice, die Datei wxsrestservice.war, im Server von WebSphere Application Server Community Edition, und starten Sie es.
    1. Kopieren und bearbeiten Sie die XML-Datei mit dem Beispielimplementierungsplan Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo-web.xml. Fügen Sie die Pfadabhängigkeiten zur Konfigurations-JAR bzw. zum Konfigurationsverzeichnis Ihres REST-Datenservice hinzu. Sehen Sie sich das Beispiel zum Definieren des Klassenpfads an, um Ihre Datei wxsRestService.properties sowie andere Konfigurationsdateien und Metadatenklassen hinzuzufügen.
    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 den Link Neu Implementieren auf der linken Seite des Konsolfensters.
    4. Geben Sie auf der Seite Neue Anwendungen installieren die folgenden Werte in die Textfelder ein:
      Tabelle 2. Neue Anwendungen installieren
      Textfeld Wert
      Archiv Ausgangsverzeichnis_des_REST-Service/lib/wxsrestservice.war
      Plan Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo-web.xml
      Tipp: Verwenden Sie den Pfad zur Datei geronimo-web.xml, die Sie in Schritt 3 kopiert und bearbeitet haben.
    5. Klicken Sie auf die Schaltfläche "Installieren". Auf der Konsolseite sollte daraufhin angezeigt werden, dass die Anwendung erfolgreich installiert und gestartet werden.
    6. Untersuchen Sie das Systemausgabeprotokoll oder die Konsole von WebSphere Application Server Community Edition, um sicherzustellen, dass der REST-Datenservice erfolgreich gestartet wurde. Die folgende Nachricht muss vorhanden sein:

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

  6. Starten Sie den Server von WebSphere Application Server Community Edition mit dem folgenden Befehl:
    • [Unix][Linux] WASCE-Stammverzeichnis/bin/startup.sh
    • [Windows] WASCE-Stammverzeichnis/bin/startup.bat
  7. 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. 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 der linken Seite des Konsolfensters auf den Link "Repository".
      3. Tragen Sie im Abschnitt Archiv dem Repository hinzufügen Folgendes in die Eingabetextfelder ein:
        Tabelle 3. Archiv dem Repository hinzufügen
        Textfeld Wert
        Datei WXS-Ausgangsverzeichnis/lib/ogclient.jar
        Gruppe com.ibm.websphere.xs
        Artefakt ogclient
        Version 7.1
        Typ JAR
      4. Klicken Sie auf die Schaltfläche "Installieren".
        Tipp: Suchen Sie im folgenden technischen Hinweis nach Einzelheiten zu den verschiedenen Methoden für die Konfiguration von Klassen- und Bibliotheksabhängigkeiten: Specifying external dependencies to applications running on WebSphere Application Server Community Edition.
    2. Implementieren Sie das REST-Datenservicemodul wxsrestservice.war 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.
      3. Klicken Sie auf den Link Neu Implementieren auf der linken Seite des Konsolfensters.
      4. Geben Sie auf der Seite Neue Anwendungen installieren die folgenden Werte in die Textfelder ein:
        Tabelle 4. Neue Anwendungen installieren
        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 daraufhin angezeigt werden, dass die Anwendung erfolgreich installiert und gestartet werden.

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

        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 WebSphere Application Server Community Edition ist 8080 und wird mit der Eigenschaft "HTTPPort" in der Datei /var/config/config-substitutions.properties definiert.

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

Ergebnisse

Das Dokument des AtomPub-Service wird angezeigt.