eXtreme-Scale-Bundles installieren

WebSphere eXtreme Scale enthält Bundles, die in einem Eclipse-Equinox-OSGi-Framework installiert werden können. Diese Bundles sind erforderlich, um eXtreme-Scale-Server zu starten oder um eXtreme-Scale-Clients in OSGi zu verwenden. Sie können die Bundles von eXtreme Scale mit der Equinox-Konsole oder mithilfe der Konfigurationsdatei "config.ini" installieren.

Vorbereitende Schritte

In dieser Task wird davon ausgegangen, dass Sie die folgenden Produkte installiert haben:

Informationen zu diesem Vorgang

eXtreme Scale enthält zwei Bundles. In einem OSGi-Framework ist nur eines der folgenden Bundles erforderlich:
objectgrid.jar
Das Server-Bundle ist die Datei objectgrid.jar, die mit der eigenständigen eXtreme-Scale-Serverinstallation installiert wird und die für die Ausführung von eXtreme-Scale-Servern erforderlich ist. Das Server-Bundle kann auch für die Ausführung von eXtreme-Scale-Clients oder lokalen speicherinternen Caches verwendet werden. Die Bundle-ID für die Datei objectgrid.jar ist "com.ibm.websphere.xs.server_<Version>", wobei Version das folgende Format hat: <Version>.<Release>.<Modifikation>. Das Server-Bundle für dieses Release ist beispielsweise com.ibm.websphere.xs.server_8.5.0.
ogclient.jar
Das Bundle ogclient.jar wird mit eigenständigen Installationen und Clientinstallationen von eXtreme Scale installiert und wird verwendet, um eXtreme-Scale-Clients oder lokale speicherinterne Caches auszuführen. eXtreme Scale Die Bundle-ID für die Datei ogclient.jar ist "com.ibm.websphere.xs.client_<Version>", wobei die Version das folgende Format hat: <Version>_<Release>_<Modifikation. Das Client-Bundle für dieses Release ist beispielsweise com.ibm.websphere.xs.server_8.5.0.
Weitere Informationen zum Entwickeln von eXtreme-Scale-Plug-ins finden Sie im Artikel System-APIs und Plug-ins.

Installiere Sie das Client- oder Server-Bundle von eXtreme Scale über die Equinox-Konsole im Eclipse-Equinox-OSGi-Framework.

Vorgehensweise

  1. Starten Sie das Eclipse-Equinox-Framework mit aktivierter Konsole, z. B.:

    Java-Ausgangsverzeichnis/bin/java -jar <equinox-Stammverzeichnis>/plugins/org.eclipse.osgi_3.6.1.R36x_v20100806.jar -console

  2. Installieren Sie das Client- oder Server-Bundle von eXtreme Scale in der Equinox-Konsole:
    osgi> install file:///<Pfad_zum_Bundle>
  3. Equinox zeigt die Bundle-ID für das neu installierte Bundle an:
    Bundle id is 25
  4. Starten Sie das Bundle in der Equinox-Konsole, wobei <ID> für die Bundle-ID steht, die dem Bundle bei der Installation zugeordnet wurde:
    osgi> start <ID>
  5. Rufen Sie den Servicestatus in der Equinox-Konsole ab, um sicherzustellen, dass das Bundle gestartet wurde, z. B.:
    osgi> ss 
    Wenn das Bundle erfolgreich gestartet wird, wird der Status ACTIVE für das Bundle angezeigt, z. B.:
    25      ACTIVE      com.ibm.websphere.xs.server_8.5.0

Client- oder Server-Bundle von eXtreme Scale mit der Datei config.ini im Eclipse-Equinox-OSGi-Framework installieren:

Vorgehensweise

  1. Kopieren Sie das eXtreme-Scale-Client- oder Server-Bundle (objectgrid.jar oder ogclient.jar) aus dem Verzeichnis <WXS-Installationsstammverzeichnis>/ObjectGrid/lib in das Eclipse-Equinox-Plug-in-Verzeichnis, z. B.: <equinox-Stammverzeichnis>/plugins
  2. Bearbeiten Sie die Eclipse-Equinox-Konfigurationsdatei config.ini, und fügen Sie das Bundle der Eigenschaft "osgi.bundles" hinzu, z. B.:
    osgi.bundles=\
    org.eclipse.osgi.services_3.2.100.v20100503.jar@1:start, \
    org.eclipse.osgi.util_3.2.100.v20100503.jar@1:start, \
    org.eclipse.equinox.cm_1.0.200.v20100520.jar@1:start, \
    objectgrid.jar@1:start
    Wichtig: Vergewissern Sie sich, dass dem letzten Bundlenamen eine leere Zeile folgt. Jedes Bundle wird durch ein Komma abgetrennt.
  3. Starten Sie das Eclipse-Equinox-Framework mit aktivierter Konsole, z. B.:

    Java-Ausgangsverzeichnis/bin/java -jar <equinox-Stammverzeichnis>/plugins/org.eclipse.osgi_3.6.1.R36x_v20100806.jar -console

  4. Rufen Sie den Servicestatus in der Equinox-Konsole ab, um sicherzustellen, dass das Bundle gestartet wurde:
    osgi> ss
    Wenn das Bundle erfolgreich gestartet wird, wird der Status ACTIVE für das Bundle angezeigt, z. B.:
    25      ACTIVE      com.ibm.websphere.xs.server_8.5.0

Ergebnisse

Sie haben das Server- oder Client-Bundle von eXtreme Scale im Eclipse-Equinox-OSGi-Framework installiert und gestartet.