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.
- WebSphere Application
Server mit eigenständigem Client von WebSphere eXtreme Scale:
- WebSphere eXtreme Scale Trial Version
7.1 mit dem REST-Datenservice wurde heruntergeladen und entpackt, oder das Produkt
WebSphere eXtreme Scale Version 7.1.0.0 mit dem kumulativen
Fix 2 wurde in einem eigenständigen Verzeichnis installiert.
- WebSphere Application
Server Version 6.1.0.25
oder 7.0.0.5 oder höher ist installiert und aktiv.
- WebSphere Application
Server mit WebSphere eXtreme Scale integriert:
WebSphere eXtreme Scale Version 7.1.0.0 mit
dem kumulativen Fix 2 oder höher wurde in WebSphere Application
Server Version 6.1.0.25 oder 7.0
oder höher installiert.
Tipp: Der REST-Datenservice von WebSphere eXtreme Scale
setzt nur voraus, dass die Clientoption von
WebSphere eXtreme Scale installiert ist.
Das Profil muss nicht erweitert werden.
Informationen zum Aktivieren der
Java-2-Sicherheit finden Sie im Information Center von
WebSphere Application
Server.
Vorgehensweise
- Konfigurieren und starten Sie ein Datengrid.
- Einzelheiten zum Konfigurieren eines Datengrids für den REST-Datenservice finden Sie unter
Datengrid für REST-Datenservices in WebSphere Application Server starten.
- 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.
- 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.
- Fügen Sie die Konfigurations-JAR-Datei bzw. das
Konfigurationsverzeichnis für den REST-Datenservice dem Klassenpfad des Anwendungsservers hinzu:
- Öffnen Sie die Administrationskonsole von WebSphere Application
Server.
- Navigieren Sie zu .
- Klicken Sie auf Neu.
- Fügen Sie den entsprechenden Feldern die folgenden Einträge hinzu:
- Name: extremescale_rest_configuration
- Klassenpfad: <Konfigurations-JAR oder -Verzeichnis für REST-Service>
- Klicken Sie auf OK.
- Speichern Sie die Änderungen in der Masterkonfiguration.
- 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.
- Öffnen Sie die Administrationskonsole von WebSphere Application
Server.
- Navigieren Sie zu .
- Klicken Sie auf Neu.
- 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.
- Klicken Sie auf OK.
- Speichern Sie die Änderungen in der Masterkonfiguration.
- Installieren Sie die EAR-Datei des REST-Datenservice wxsrestservice.ear
über die Administrationskonsole in WebSphere Application
Server:
- Öffnen Sie die Administrationskonsole von WebSphere Application
Server.
- Klicken Sie auf .
- 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.
- Wählen Sie die Option für detaillierte Installation aus, und klicken Sie auf
Weiter.
- Klicken Sie in der Anzeige mit Anwendungssicherheitswarnungen auf Weiter.
- Wählen Sie die Standardinstallationsoptionen aus, und klicken Sie auf Weiter.
- Wählen Sie einen Server aus, dem Sie die Anwendung zuordnen möchten, und klicken Sie auf
Weiter.
- Verwenden Sie auf der Seite für das erneute Laden von JSP-Dateien die Standardeinstellungen, und klicken
Sie auf Weiter.
- 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.
- Verwenden Sie auf der Seite für die Zuordnung von Beziehungen zu gemeinsam genutzten Bibliotheken
die Standardeinstellungen, und klicken
Sie auf Weiter.
- Verwenden Sie auf der Seite für die Zuordnung virtueller Hosts die Standardeinstellungen, und klicken
Sie auf Weiter.
- Setzen Sie auf der Seite für die Zuordnung der Kontextstammelemente das Kontextstammelement auf
"wxsrestservice".
- Klicken Sie in der Anzeige "Zusammenfassung" auf Fertig stellen, um die Installation
durchzuführen.
- Speichern Sie die Änderungen in der Masterkonfiguration.
- Starten Sie die REST-Datenserviceanwendung wxsrestservice.
- Wechseln Sie in der Administrationskonsole zu der Anwendung.
- WebSphere Application
Server Version 7.0:
Klicken Sie in der Administrationskonsole auf
.
- WebSphere Application
Server Version 6.1:
Klicken Sie in der Administrationskonsole auf .
- Wählen Sie das Kontrollkästchen neben der Anwendung wxsrestservice aus, und klicken Sie auf
Starten.
- 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.
- 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.
- Zum Stoppen der Datengridprozesse verwenden Sie die Tastenkombination
STRG+C im entsprechenden Befehlsfenster.