JDBC-Verbindung des Typs 4 für global koordinierte Transaktionen konfigurieren

Wenn die Datenbank, auf die Sie über eine JDBC-Verbindung des Typs 4 zugreifen, an global koordinierten Transaktionen teilnehmen soll, richten Sie die entsprechende Umgebung ein.

Vorbereitungen

Richten Sie Ihre JDBC -Providerdefinition ein.

Informationen zu dieser Task

In verteilten Systemen übernimmt ein mit dem Integrationsknoten verbundener Queue-Manager von „ IBM® MQ “ die Rolle des Transaktionsmanagers, was bedeutet, dass „ IBM App Connect Enterprise “ bei der Verarbeitung von Nachrichten Zugriff auf „ IBM MQ “ benötigt. Weitere Informationen zur Verwendung von „ IBM MQ “ mit „ IBM App Connect Enterprise “ finden Sie unter „Installation von IBM MQ “.

Datenbankaktualisierungen über eine JDBC-Verbindung vom Typ 4 können mit anderen Aktionen innerhalb des Nachrichtenflusses koordiniert werden, wenn Sie die Ressourcen entsprechend für eine solche Koordination konfigurieren.

Führen Sie die folgenden Schritte aus:

Vorgehensweise

  1. Überprüfen Sie, ob die Definition für Ihre JDBC-Provider-Richtlinie für koordinierte Transaktionen geeignet ist.

    Gehen Sie beispielsweise wie folgt vor, um die erforderlichen JDBC-Klassen einzurichten:

    • Für Db2® setzen Sie JDBC type 4 data source class name auf com.ibm.db2.jcc.DB2XADataSource und JDBC driver class name auf com.ibm.db2.jcc.DB2Driver.
    • Setzen Sie für Oracle JDBC type 4 data source class name auf oracle.jdbc.xa.client.OracleXADataSource und JDBC driver class name auf oracle.jdbc.OracleDriver.
    Wenden Sie sich an den Datenbankadministrator oder schlagen Sie in der vom Datenbankanbieter bereitgestellten Dokumentation nach, um sicherzustellen, dass alle Eigenschaften für die JDBC-Provider-Richtlinie korrekt festgelegt sind. Es kann beispielsweise sein, dass ein Datenbankanbieter sicheren Zugriff fordert, wenn die Datenbank an koordinierten Transaktionen teilnimmt.
  2. Definieren Sie die Switchdatei und die Datenbankeigenschaften:
    1. Die Switch-Datei „ JDBC “ wird von IBM App Connect Enterprise bereitgestellt und nutzt die statische Registrierung unter XA (siehe „Konfigurieren von Datenbanken für die globale Transaktionskoordination“ ).
    2. Linux-PlattformÖffnen Sie auf Linux® -und UNIX -Systemen die Datei qm.ini für den Warteschlangenmanager des Integrationsknotens mit einem Texteditor. Fügen Sie für jede Datenbank folgende Zeilengruppe hinzu:
      XAResourceManager:
             Name=Database_Name 
             SwitchFile=JDBCSwitch
             XAOpenString=JDBC_DataSource
             ThreadOfControl=THREAD 
      

      Datenbankname steht für den Datenbanknamen der Datenbank, die in der JDBC-Provider-Richtlinie definiert ist.

      JDBCSwitch ist ein fester generischer Name für die Switchdatei zur XA-Koordination. Verwenden Sie diesen bzw. einen anderen einzelnen festen Wert in jeder Zeilengruppe. Die spezielle vom Warteschlangenmanager verwendete Switchdatei wird durch die im nächsten Schritt erstellten symbolischen Verbindungen definiert.

      JDBC_Datenquelle steht für die ID der JDBC-Provider-Richtlinie.

      Definieren Sie eine Zeilengruppe für jede Datenbank (DSN), zu der Sie von diesem Integrationsservereine Verbindung herstellen. Separate Definitionen sind selbst dann erforderlich, wenn die DSNs in dieselbe physische Datenbank aufgelöst werden. Deshalb muss für jede JDBC-Provider-Richtlinie, die Sie definiert haben, eine Zeilengruppe vorhanden sein, da jeder Service die Eigenschaften für eine einzelne Datenbank definieren kann.

    3. Windows-PlattformÖffnen Sie unter Windows den „ IBM MQ -Explorer“ und wählen Sie den Queue-Manager aus, zum Beispiel BROKERQM.

      Öffnen Sie die Seite XA-Ressourcenmanager und ändern Sie die Attribute, um die Definition der Datenbank zu erstellen. Die Attribute entsprechen denen, die für „ Linux “ und „UNIX“ angegeben sind: „Name“, „SwitchFile“, „XAOpenString “ und „ ThreadofControl “. Lassen Sie das zusätzliche Attribut XACloseString leer.

      Geben Sie JDBCSwitch in SwitchFile ein.

  3. Richten Sie Warteschlangenmanagerzugriff auf die Switchdatei ein.
    1. Linux-PlattformErstellen Sie auf Linux- und UNIX -Systemen einen symbolischen Link zu den Switchdateien, die im Verzeichnis install_dir/server/lib bereitgestellt werden.

      install_dir ist das Verzeichnis, in dem Sie „ IBM App Connect Enterprise “ installiert haben. Der Standardspeicherort für dieses Verzeichnis ist install_dir/ace-13.0.n.0/server unter Windows „ Linux “ und /opt/IBM/mqsi/13.0.n.0/server unter UNIX -Systemen „/“. Das Standardverzeichnis enthält Version, Release, Modifikationsstufe und Fix-Level des Produkts im Format v.r.m.f (version.release.modifikation.fix).

      Definieren Sie Links im Verzeichnis /var/mqm/exits64. Der Dateiname für alle Plattformen ist libJDBCSwitch.so.

      Geben Sie denselben Namen der Switchdatei ( JDBCSwitch ) oder einen eigenen Wert im Verzeichnis /exits64 an. Beispiel für AIX®:
      ln -s install_dir/server/lib/libJDBCSwitch.so /var/mqm/exits64/JDBCSwitch
    2. Windows-PlattformKopieren Sie unter Windows die JDBCSwitch32.dll Datei aus dem install_dir\server\bin Verzeichnis in das \exits Unterverzeichnis im Installationsverzeichnis von „ IBM MQ “ und benennen Sie die Datei um in JDBCSwitch.dll. Kopieren Sie anschließend die JDBCSwitch.dll Datei aus dem install_dir\server\bin Verzeichnis in das \exits64 Unterverzeichnis im Installationsverzeichnis von „ IBM MQ “.
  4. Konfigurieren Sie den Nachrichtenfluss, der einen oder mehrere Knoten enthält, die auf Datenbanken zugreifen, die an einer global koordinierten Transaktion teilnehmen.
    1. Öffnen Sie eine Sitzung des „ IBM App Connect Enterprise “-Toolkits.
    2. Wechseln Sie zur -Perspektive 'Integrationsentwicklung'.
    3. Fügen Sie den Nachrichtenfluss hinzu, der den oder die Knoten enthält, die eine Verbindung zu der Datenbank herstellen, die an einer global koordinierten Transaktion zu einer neuen oder bestehenden Brokerarchivdatei teilnehmen soll.
    4. Erstellen Sie die Brokerarchivdatei.
    5. Klicken Sie auf die Registerkarte Konfigurieren , wählen Sie den hinzugefügten Nachrichtenfluss aus und wählen Sie das Kontrollkästchen Koordinierte Transaktion aus.

Nächste Schritte

Wenn Ihr Integrationsknoten unter Windowsausgeführt wird, berechtigen Sie den Warteschlangenmanager für den Zugriff auf Ressourcen, die der JDBC -Providerrichtlinie zugeordnet sind (siehe Zugriff auf JDBC-Ressourcen des Typs 4 von JDBC unter Windows erteilen).

Wenn Sie die Anweisungen unter Mit Datenbanken arbeitenausgeführt haben, ist die nächste Task ODBC -Verbindungen für global koordinierte Transaktionen konfigurieren (optional).