SDO-Repository installieren und konfigurieren

Service Data Objects (SDO) ist ein offener Standard, der Anwendungen ermöglicht, Daten aus anderen Datenquellen einheitlich als Datengraphen zu bearbeiten. SIB-fähige Web-Services verwenden ein SDO-Repository, um WSDL-Dateien zu speichern und bereitzustellen. Verwenden Sie diese Task, um die von Ihnen bevorzugte Datenbank für die Speicherung der SDO-Daten zu erstellen und zu konfigurieren und um ein SDO-Repository auf jedem Server zu installieren und zu konfigurieren, den Sie für busfähige Web-Services verwenden möchten.

Vorbereitende Schritte

Bestimmen Sie die Server oder Cluster, in denen Sie ein SDO-Repository installieren und konfigurieren möchten. Verwenden Sie dazu die Informationen im Artikel Installation busfähiger Web-Services planen. Fügen Sie anschließend jeden Server oder Cluster als Member eines Busses hinzu. Verwenden Sie hierfür die Informationen im Artikel Member eines Busses konfigurieren.

Ein SDO-Repository kann mit den meisten Datenbankprodukten verwendet werden. Spezifische Informationen zur Auswahl und Konfiguration der von Ihnen bevorzugten Datenbank erhalten Sie von Ihrem Datenbankadministrator, bzw. finden Sie in der Dokumentation zum Datenbankprodukt. Lesen Sie außerdem die Hinweise zur Datenbanknutzung in diesem Artikel.

Informationen zu diesem Vorgang

Führen Sie die folgenden Schritte aus, um ein SDO-Repository zu installieren und zu konfigurieren:
  • Installieren Sie das von Ihnen bevorzugte Datenbankprodukt.
  • Erstellen Sie einen JDBC-Provider und eine Datenquelle für Ihre Datenbank.
  • Führen Sie das Script installSdoRepository.jacl mindestens einmal aus, um die SDO-Anwendung auf jedem Server zu installieren und den Datenbanktyp festzulegen, den das SDO-Repository verwenden soll.
Lesen Sie hierzu zuerst die Informationen zur Datenbanknutzung und zum Script installSdoRepository.jacl, und führen Sie anschließend die Schritte für eine der folgenden Konfigurationen aus:
Hinweise zur Datenbanknutzung:
  • [AIX Solaris HP-UX Linux Windows][IBM i]Für eine Konfiguration mit einem einzigen Server können Sie die von Ihnen bevorzugte Datenbank oder die integrierte Apache Derby-Datenbank, die mit WebSphere Application Server bereitgestellt wird, verwenden. [z/OS]In einer z/OS-Umgebung kann die eingebettete Derby-Datenbank nicht verwendet werden, weil nur jeweils ein Prozess auf diese Datenbank zugreifen kann und unter z/OS selbst ein einzelner Server in mehreren Prozessen ausgeführt werden kann.
  • Für eine Network Deployment-Konfiguration können Sie die von Ihnen bevorzugte Datenbank oder die bereitgestellte Datenbank des Typs "Cloudscape Version 10.1.x (Derby)" und die zugehörige Network-Server-Anwendung verwenden. Beachten Sie jedoch die Einschränkungen, die für Derby Network Server gelten. Es werden beispielsweise keine Transaktionen unterstützt.
  • Das SDO-Repository bestimmt das verwendete Schema und die Tabellennamen. Deshalb müssen unterschiedliche Repositorys unterschiedliche Datenbanken verwenden, damit gewährleistet ist, dass sie nicht auf dieselben Daten zugreifen.Verwenden Sie ein SDO-Repository für jede Zelle. Wenn Sie also mehrere Zellen haben, müssen Sie mehrere Datenbanken verwenden, eine für jede Zelle.
  • [z/OS]DB2 unter z/OS bietet keine Unterstützung für die Verwendung mehrerer Datenbanken. Auf z/OS-Systemen muss jedes SDO-Repository eine andere DB2-Instanz verwenden, um sicherzustellen, dass die Repositorys nicht auf dieselben Daten zugreifen.
  • Erstellen Sie die Datenbank für Ihren bevorzugten Datenbankanbieter mit der Datei Table.ddl im entsprechenden Verzeichnis Stammverzeichnis_des_Anwendungsservers/util/SdoRepository/Datenbanktyp. Die Datei Table.ddl beschreibt die Datenbanktabelle, die das SDO-Repository benötigt.
  • Das Flag -editBackendId, das mit dem Script installSdoRepository.jacl angegeben wird, bestimmt den vom Repository zu verwendenden Datenbanktyp. Die Backend-ID bestimmt, welche datenbankspezifischen Regeln die Anwendung bei der Kommunikation mit der Datenbank anwendet. Lesen Sie die Anmerkung zum Script installSdoRepository.jacl.
  • Einige Datenbanken erfordern eine Benutzer-ID, der die Berechtigungen für den Zugriff auf die SDO-Repositorydatenbank erteilt wurden. Erstellen Sie eine Benutzer-ID für den Benutzernamen SDOREP, bevor Sie die Tabellen für Oracle-, Sybase- und SQL-Server-Datenbanken erstellen. Wegen der Art und Weise, in der diese Datenbanken Benutzernamen und Tabellennamen behandeln, muss der Benutzername SDOREP sein, damit das SDO-Repository mit dem vollständig qualifizierten Namen SDOREP.BYTESTORE auf seine Tabelle zugreifen kann. Stellen Sie sicher, dass Sie dem Benutzer SDOREP die erforderlichen Berechtigungen zum Lesen und Schreiben in der Datenbank zuweisen.
  • Wenn Sie eine Informix-Datenbank verwenden, inaktivieren Sie die Protokollierung nicht.
  • Das SDO-Repository erfordert keine XA-Unterstützung. In den meisten Fällen können Sie eine XA- oder Nicht-XA-Datenquelle verwenden. Wenn Sie jedoch mit Oracle 8 oder 9 arbeiten, müssen Sie den Oracle-JDBC-Treiber (Nicht-XA) für die Datenquelle des SDO-Repository verwenden.
  • Sie können auch weitere Schritte ausführen, beispielsweise einen Index der Primärschlüssel erstellen, um die Leistung der Datenbank zu verbessern. Schema-, Tabellen- und Spaltennamen sollten nicht geändert werden.
  • Wenn Sie dieses SDO-Repository für eine Zelle konfigurieren, die Anwendungsserver der WebSphere Application Server Version 6.0, der Version 6.1 und höher enthält, müssen Sie eine Datenbank verwenden, die mit allen diesen Versionen kompatibel ist.
Anmerkungen zum Script installSdoRepository.jacl:
  • Verwenden Sie den Scripting-Client wsadmin, um das Script auszuführen.
  • [IBM i]Führen Sie das Script in der QShell aus.
  • Das Script wird im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin bereitgestellt, wobei Stammverzeichnis_des_Anwendungsservers für das Stammverzeichnis der Installation von WebSphere Application Server steht. Wenn Sie den Scripting-Client "wsadmin" in einem anderen Verzeichnis ausführen möchten, müssen Sie mit der Befehlsoption den vollständigen Pfad des Scripts angeben. Wenn das Konsolenmodul in einem anderen als dem standardmäßig verwendeten Anwendungsserverprofil implementiert werden soll, wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/Profilname/bin, und geben Sie den folgenden Pfad zum Script ein: [IBM i]
    wsadmin -f Stammverzeichnis_des_Anwendungsservers/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f Stammverzeichnis_des_Anwendungsservers/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS].ext steht für die Dateierweiterung .bat für ein Windows-System bzw. .sh für ein UNIX-, Linux- oder z/OS-System.
  • Das Flag -editBackendId, das mit dem Script installSdoRepository.jacl angegeben wird, bestimmt den vom Repository zu verwendenden Datenbanktyp. Die Backend-ID bestimmt, welche datenbankspezifischen Regeln die Anwendung bei der Kommunikation mit der Datenbank anwendet. Verwenden Sie zum Anzeigen der vollständigen Liste der verfügbaren Backend-IDs das Flag -listBackendIds:
    wsadmin -f installSdoRepository.jacl -listBackendIds
    Alle Back-End-ID-Werte in der Liste können verwendet werden, wenn das SDO-Repository in einem oder mehreren Anwendungsservern von WebSphere Application Server Version 7.0 oder höher installiert ist. Mit einem Stern (*) markierte Werte können nicht verwendet werden, wenn das SDO-Repository in Servern der Version 6.0 installiert ist. Mit zwei Sternen (**) markierte Werte können nicht verwendet werden, wenn das SDO-Repository in Servern der Version 6.0 oder Version 6.1 installiert ist.
  • Wenn die Datenquelle bereits vorhanden ist oder es eine vorherige fehlerhafte oder Teilinstallation der SDO-Repository-Anwendung gibt, kann das Script installSdoRepository.jacl nicht ausgeführt werden, und die Konfigurationsänderungen werden nicht gespeichert. In diesen Fällen führen Sie das Deinstallationsscript für das SDO-Repository aus, beheben das Problem und führen anschließend das Script installSdoRepository.jacl aus.
[IBM i][AIX Solaris HP-UX Linux Windows]

SDO-Repository für einen einzigen Server und die Verwendung der integrierten Derby-Datenbank konfigurieren

[z/OS]

Vorbereitende Schritte

[z/OS]In einer z/OS-Umgebung kann die eingebettete Derby-Datenbank nicht verwendet werden, weil nur jeweils ein Prozess auf diese Datenbank zugreifen kann und unter z/OS selbst ein einzelner Server in mehreren Prozessen ausgeführt werden kann.

Informationen zu diesem Vorgang

Wenn Sie eine Einzelserverkonfiguration erstellen und die eingebettete Derby-Datenbank verwenden möchten, führen Sie das Script installSdoRepository.jacl mit dem Schalter -createDb aus. Bei dieser Aktion wird die Derby-Datenbank erstellt und das SDO-Repository installiert.

Führen Sie die folgenden Schritte aus, um das SDO-Repository für einen einzelnen Server mit der eingebetteten Derby-Datenbank zu konfigurieren:

Vorgehensweise

  1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.
  2. Geben Sie den folgenden Befehl ein: [IBM i]
    wsadmin -f installSdoRepository.jacl -createDb
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f installSdoRepository.jacl -createDb
    Anmerkung: Das Flag -createDb teilt dem Befehl mit, eine Derby-Standarddatenbank zu erstellen. Wenn Sie dieses Flag nicht angeben, installiert der Befehl trotzdem ein SDO-Repository, das für Derby konfiguriert ist, aber der Befehl erstellt nicht die Datenbank.

SDO-Repository für einen einzelnen Server mit einer anderen als der eingebetteten Derby-Datenbank konfigurieren

Informationen zu diesem Vorgang

Wenn Sie eine Einzelserverkonfiguration erstellen möchten, die eine andere als die eingebettete Derby-Datenbank verwendet, müssen Sie das von Ihnen bevorzugte Datenbankprodukt installieren, einen JDBC-Provider und eine Datenquelle erstellen und anschließend das Script installSdoRepository.jacl zweimal ausführen:
  1. einmal, um die SDO-Anwendung im Anwendungsserver zu installieren und
  2. einmal zum Festlegen des Datenbanktyps, den das SDO-Repository verwenden soll.

Führen Sie die folgenden Schritte aus, um das SDO-Repository für einen einzelnen Server mit einer anderen als der eingebetteten Derby-Datenbank zu konfigurieren:

Vorgehensweise

  1. Erstellen Sie die Datenbank für Ihren bevorzugten Datenbankanbieter mit der Datei Table.ddl im entsprechenden Verzeichnis Stammverzeichnis_des_Anwendungsservers/util/SdoRepository/Datenbanktyp.

    Eine Abbildung zum Ablauf beim Erstellen von Tabellen in DB2 finden Sie im Artikel Datenbanktabellen aus der exportierten Tabellendatendefinitionssprache erneut erstellen. Weitere Informationen finden Sie im Artikel Implementierung von Anwendungen für Datenzugriff.

  2. Erstellen Sie einen J2C-Authentifizierungsalias.

    Dies ist für die Datenquelle bestimmt, die Sie im nächsten Schritt erstellen. Vergewissern Sie sich, dass der Authentifizierungsalias mit den Anmeldedetails für Ihre Datenbankinstanz übereinstimmt. Andernfalls wird die Verbindung nicht hergestellt.

  3. Erstellen und konfigurieren Sie einen JDBC-Provider und eine Datenquelle.
    Definieren Sie die folgenden Datenquelleneigenschaften:
    • Setzen Sie die Eigenschaft Authentifizierung so, dass der im vorherigen Schritt erstellte Authentifizierungsalias verwendet wird.
    • Wählen Sie das Kontrollkästchen Diese Datenquelle für CMP verwenden aus.
    • Setzen Sie die Eigenschaft Name auf einen von Ihnen ausgewählten Namen, z. B. Datenquelle für SDO-Repository.
    • Setzen Sie die Eigenschaft JNDI-Name auf den folgenden genauen Wert: jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Setzen Sie alle anderen Eigenschaften, die erforderliche Einstellungen für die ausgewählte Datenbank sind.
  4. Optional: Testen Sie die Verbindung zur Datenquelle:
    Anmerkung: Diese Option ist nicht für alle Konfigurationen gleichermaßen gut geeignet. Die Verfügbarkeit dieser Option richtet sich nach dem Geltungsbereich, für den die Datenquelle definiert wurde, und dem Geltungsbereich aller Variablen von WebSphere Application Server, die in den Konfigurationen von JDBC-Provider und Datenquelle verwendet werden. Weitere Informationen zum Testen von Verbindungen zu Datenquellen finden Sie im Artikel Service für das Testen von Verbindungen.
    1. Navigieren Sie in der Administrationskonsole zu Ressourcen -> JDBC -> Datenquellen.
    2. Wählen Sie die Datenquelle für das SDO-Repository aus.
    3. Klicken Sie auf Verbindung testen.
  5. Konfigurieren Sie das SDO-Repository:
    1. Öffnen Sie eine Eingabeaufforderung, und wechseln Sie dann in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.
    2. Installieren Sie die SDO-Repository-Anwendung auf dem Server: [IBM i]
      wsadmin -f installSdoRepository.jacl
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl
    3. Legen Sie den Datenbanktyp für das SDO-Repository fest:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId Datenbanktyp
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId Datenbanktyp
      Beispiel:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82

SDO-Repository für eine Network Deployment-Zelle konfigurieren

Informationen zu diesem Vorgang

Wenn Sie mit einer Network Deployment-Umgebung arbeiten, müssen Sie Ihr bevorzugtes Datenbankprodukt installieren, anschließend einen JDBC-Provider und eine Datenquelle erstellen und dann das Script installSdoRepository.jacl für jede Zelle mehrfach ausführen:
  1. einmal zum Installieren der SDO-Anwendung im Deployment Manager,
  2. einmal zum Festlegen des Datenbanktyps, den das SDO-Repository verwenden soll.
  3. und mehrfach für die Installation einer Instanz der SDO-Anwendung in jedem Server oder Cluster, den Sie für eine oder mehrere Rollen der busfähigen Web-Services verwenden möchten.

Zum Konfigurieren des SDO-Repository für eine Network Deployment-Zelle führen Sie die folgenden Schritte aus:

Vorgehensweise

  1. Erstellen Sie die Datenbank für Ihren bevorzugten Datenbankanbieter mit der Datei Table.ddl im entsprechenden Verzeichnis Stammverzeichnis_des_Anwendungsservers/util/SdoRepository/Datenbanktyp.

    Eine Abbildung zum Ablauf beim Erstellen von Tabellen in DB2 finden Sie im Artikel Datenbanktabellen aus der exportierten Tabellendatendefinitionssprache erneut erstellen. Weitere Informationen finden Sie im Artikel Implementierung von Anwendungen für Datenzugriff.

  2. Erstellen Sie auf allen betroffenen Knoten, einschließlich des Deployment-Manager-Knotens die folgenden Variablen von WebSphere Application Server auf Knotenebene:
    Anmerkung: Je nach Konfiguration können diese Variablen auf Knoten- oder auf Zellenebene gesetzt werden. Für Knoten unterschiedlicher Plattformen können Sie WAS_INSTALL_ROOT jedoch nicht auf Zellenebene definieren, weil die Knoten unterschiedliche Installationsverzeichnisse haben.
    1. Navigieren Sie in der Administrationskonsole zu Umgebung -> WebSphere-Variablen, und legen Sie anschließend den Geltungsbereich auf "Knoten" fest.
    2. Stellen Sie sicher, dass die Variable WAS_INSTALL_ROOT vorhanden ist und auf das Stammverzeichnis der Installation von WebSphere Application Server gesetzt ist.
    3. Erstellen Sie eine neue Variable Ihre_Datenbank_JDBC_DRIVER_PATH mit dem Wert der Position, an der die JAR-Dateien Ihrer Datenbank (in einem späteren Schritt) auf jeder Hostmaschine in der Zelle gespeichert werden.
  3. Erstellen Sie einen J2C-Authentifizierungsalias.

    Dies ist für die Datenquelle bestimmt, die Sie im nächsten Schritt erstellen. Vergewissern Sie sich, dass der Authentifizierungsalias mit den Anmeldedetails für Ihre Datenbankinstanz übereinstimmt. Andernfalls wird die Verbindung nicht hergestellt.

  4. Erstellen und konfigurieren Sie einen JDBC-Provider und eine Datenquelle.
    Definieren Sie die folgenden Datenquelleneigenschaften:
    • Setzen Sie die Eigenschaft Authentifizierung so, dass der im vorherigen Schritt erstellte Authentifizierungsalias verwendet wird.
    • Wählen Sie das Kontrollkästchen Diese Datenquelle für CMP verwenden aus.
    • Setzen Sie die Eigenschaft Name auf einen von Ihnen ausgewählten Namen, z. B. Datenquelle für SDO-Repository.
    • Setzen Sie die Eigenschaft JNDI-Name auf den folgenden genauen Wert: jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Setzen Sie alle anderen Eigenschaften, die erforderliche Einstellungen für die ausgewählte Datenbank sind.
  5. Implementieren Sie die JAR-Dateien für den Datenbankclient auf jeder Hostmaschine in der Zelle.

    Die JAR-Dateien müssen an der Position implementiert werden, die Sie mit der Variablen Ihre_Datenbank_JDBC_DRIVER_PATH, die Sie in einem der vorherigen Schritte deklariert haben, angegeben haben. Andernfalls können ferne Knoten keine Verbindung zum SDO-Repository herstellen.

  6. Konfigurieren Sie das SDO-Repository:
    1. Öffnen Sie eine Eingabeaufforderung, und wechseln Sie dann in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.
    2. Installieren Sie die SDO-Repository-Anwendung im Deployment Manager für diese Zelle: [IBM i]
      wsadmin -f installSdoRepository.jacl Name_des_Deployment-Manager-Knotens Name_des_Deployment-Manager-Servers
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl Name_des_Deployment-Manager-Knotens Name_des_Deployment-Manager-Servers
      Beispiel:[IBM i]
      wsadmin -f installSdoRepository.jacl dmgrNode dmgr
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.sh -f installSdoRepository.jacl dmgrNode dmgr
    3. Legen Sie den Datenbanktyp für das SDO-Repository fest:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId Datenbanktyp
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId Datenbanktyp
      Beispiel:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82
    4. Installieren Sie eine Instanz des SDO-Repository in jedem Server oder Cluster, den Sie für eine oder mehrere Rollen der busfähigen Web-Services verwenden möchten:
      • Wiederholen Sie den folgenden Befehl für jeden Server, der nicht zu einem Cluster gehört: [IBM i]
        wsadmin -f installSdoRepository.jacl Knotenname Servername
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl Knotenname Servername
      • Wiederholen Sie den folgenden Befehl für jeden Cluster: [IBM i]
        wsadmin -f installSdoRepository.jacl -cluster Clustername
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl -cluster Clustername

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_install_sdo
Dateiname:tjw_install_sdo.html