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
- Eine JRE oder ein JDK von IBM® (empfohlen) oder Oracle
der Version 5 oder höher ist installiert, und eine Umgebungsvariable JAVA_HOME ist definiert.
- 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. Informationen zu
Version 2.1.1 bzw.
anderen Versionen finden Sie in den Installationsanweisungen.
Vorgehensweise
- Datengrid konfigurieren und starten.
- Einzelheiten zum Konfigurieren eines Datengrids von
eXtreme Scale für den REST-Datenservice finden Sie unter
Eigenständiges Datengrid für REST-Datenservices starten.
- 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.
- 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.
- Starten Sie den Server von WebSphere Application Server Community Edition:
- Führen Sie den folgenden Befehl aus, um den Server ohne aktivierte Java-SE-Sicherheit zu starten:
![[Unix]](./icons/ngunix.gif)
WASCE-Stammverzeichnis/bin/startup.sh
WASCE-Stammverzeichnis/bin/startup.bat
- Führen Sie die folgenden Schritte aus, um den Server mit aktivierter Java-SE-Sicherheit zu starten:
![[Unix]](./icons/ngunix.gif)
- Ö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).
- Bearbeiten Sie die Datei wasce_root/bin/setenv.sh.
- Fügen Sie hinter der Zeile mit "WASCE_JAVA_HOME=" Folgendes hinzu:
export JAVA_OPTS="-Djava.security.manager
-Djava.security.policy=geronimo.policy".
- Ö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
- Bearbeiten Sie die Datei wasce_root\bin\setenv.bat.
- Fügen Sie hinter der Zeile mit "set WASCE_JAVA_HOME=" Folgendes hinzu:
set
JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"
- Fügen Sie die JAR-Datei für die ObjectGrid-Clientlaufzeitumgebung
dem Repository von
WebSphere Application Server Community Edition hinzu:
- Ö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.
- Klicken Sie im Ordner Services auf der linken Seite des Konsolfensters auf den Link Repository.
- Tragen Sie im Abschnitt Archiv dem Repository hinzufügen Folgendes in die Eingabetextfelder ein:
Tabelle 1. Archiv dem Repository hinzufügenTextfeld |
Wert |
Datei |
WXS-Ausgangsverzeichnis/lib/ogclient.jar |
Gruppe |
com.ibm.websphere.xs |
Artefakt |
ogclient |
Version |
7.1 |
Typ |
JAR |
- 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.
- Implementieren Sie das Modul des REST-Datenservice, die Datei
wxsrestservice.war, im Server von WebSphere Application Server Community Edition, und starten Sie es.
- 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.
- Ö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.
- Klicken Sie auf den Link Neu Implementieren auf der linken Seite des Konsolfensters.
- Geben Sie auf der Seite Neue Anwendungen installieren die folgenden
Werte in die Textfelder ein:
Tabelle 2. Neue Anwendungen installierenTextfeld |
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.
- Klicken Sie auf die Schaltfläche "Installieren".
Auf der Konsolseite sollte daraufhin angezeigt werden, dass die Anwendung erfolgreich installiert und gestartet werden.
- 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.
- Starten Sie den Server von WebSphere Application Server Community Edition
mit dem folgenden Befehl:
![[Unix]](./icons/ngunix.gif)
WASCE-Stammverzeichnis/bin/startup.sh
WASCE-Stammverzeichnis/bin/startup.bat
- Installieren Sie den REST-Datenservice von
eXtreme Scale und das bereitgestellte Beispiel im Server von
WebSphere Application Server Community Edition:
- Fügen Sie die JAR-Datei für die ObjectGrid-Clientlaufzeitumgebung
dem Repository von
WebSphere Application Server Community Edition hinzu:
- Ö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.
- Klicken Sie im Ordner "Services" auf der linken Seite des Konsolfensters auf den Link "Repository".
- Tragen Sie im Abschnitt Archiv dem Repository hinzufügen Folgendes in die Eingabetextfelder ein:
Tabelle 3. Archiv dem Repository hinzufügenTextfeld |
Wert |
Datei |
WXS-Ausgangsverzeichnis/lib/ogclient.jar |
Gruppe |
com.ibm.websphere.xs |
Artefakt |
ogclient |
Version |
7.1 |
Typ |
JAR |
- Klicken Sie auf die Schaltfläche "Installieren".
- Implementieren Sie das REST-Datenservicemodul wxsrestservice.war im Server von WebSphere Application Server Community Edition.
- 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.
- Öffnen Sie die Administrationskonsole von
WebSphere Application Server Community Edition, und melden Sie sich an.
- Klicken Sie auf den Link Neu Implementieren auf der linken Seite des Konsolfensters.
- Geben Sie auf der Seite Neue Anwendungen installieren die folgenden
Werte in die Textfelder ein:
Tabelle 4. Neue Anwendungen installierenTextfeld |
Wert |
Archiv |
Ausgangsverzeichnis_des_REST-Service/lib/wxsrestservice.war |
Plan |
Ausgangsverzeichnis_des_REST-Service/gettingstarted/wasce/geronimo-web.xml |
- Klicken Sie auf die Schaltfläche Installieren.
Auf der Konsolseite sollte daraufhin angezeigt werden, dass die Anwendung erfolgreich installiert und gestartet werden.
- Ü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.
- 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.