Installieren Sie Ressourcenadapter in Ihren Anwendungen, damit sie auf externe Datenquellen
zugreifen können.
Vorbereitende Schritte
Die Spezifikation JCA Version 1.6 fügt auch Unterstützung für Java-Annotationen in RAR-Modulen hinzu. Weitere Informationen
zur Unterstützung für Annotationen finden Sie im Artikel "Unterstützung von JCA 1.6 für Annotationen in RAR-Modulen".
Informationen zu diesem Vorgang
Vorgehensweise
- Assemblieren Sie eine Anwendung, die RAR-Module enthält. Weitere Informationen fnden Sie im Artikel "Anwendungen assemblieren".
- Installieren Sie die Anwendung. Führen Sie die im Artikel "Neue Anwendung installieren" beschriebenen Schritte aus.
Geben Sie bei Ausführung des Schrittes Servern Module zuordnen für jede RAR-Datei Zielserver oder
Zielcluster an. Stellen Sie sicher, dass alle übrigen Module, die die in den RAR-Modulen definierten Ressourcenadapter verwenden,
denselben Zielsystemen zugeordnet werden. Geben Sie außerdem die Web-Server als Ziel an, die als Router für Anforderungen eingesetzt werden, die an diese Anwendung gesendet werden.
Die Plug-in-Konfigurationsdatei (plugin-cfg.xml) für jeden Web-Server wird auf der Basis der Anwendungen erstellt, für die der Web-Server als Router auftritt.
Während des Schritts Metadaten für Module zur Anwendungsinstallation können Sie das Flag "metadata-complete"
wie im Artikel "Unterstützung von JCA 1.6 für Annotationen in RAR-Modulen" setzen oder eine entsprechende Einstellung zurücknehmen.
Anmerkung: Wenn Sie eine RAR-Datei auf einem Server installieren, sucht der Anwendungsserver
das Manifest (MANIFEST.MF) für das Connectormodul. Der Anwendungsserver sucht die RAR-Datei zuerst
in der Datei
connectorModule.jar und lädt dann das Manifest aus der Datei
connectorModule.jar.
Wenn der Klassenpfadeintrag im Manifest der Datei
connectorModule.jar enthalten ist, verwendet die RAR-Datei diesen Klassenpfad.
Überprüfen Sie in der Administrationskonsole die Einstellung "Klassenpfad" für die RAR-Datei, um sicherzustellen, dass das
installierte Connectormodul die erforderlichen Klassen und Ressourcen findet.
Weitere Informationen hierzu finden Sie in den Artikeln "Einstellungen des Ressourcenadapters" und "Einstellungen für WebSphere Relational Resource Adapter".
- Klicken Sie auf Fertig stellen > Speichern, um die Änderungen zu speichern.
- Erstellen Sie Verbindungsfactorys für die neu installierte Anwendung.
Im Artikel "Verbindungsfactorys für Ressourcenadapter in Anwendungen konfigurieren" ist beschrieben, wie Sie vorgehen müssen,
um diesen Schritt auszuführen.
Ergebnisse
Anmerkung: Eine gegebene native Bibliothek kann für jede Instanz der
Java™ Virtual Machine (JVM) nur einmal geladen werden. Da jede Anwendung einen eigenen Klassenlader hat,
können verschiedene Anwendungen mit integrierten RAR-Dateien nicht dieselbe native
Bibliothek verwenden. Die zweite Anwendung, die versucht, die Bibliothek zu laden, empfängt eine Ausnahme.
Wenn eine auf dem Anwendungsserver implementierte
Anwendung eine integrierte RAR-Datei mit nativen Pfadelementen verwendet, müssen Sie immer sicherstellen,
dass der Anwendungsserver ordnungsgemäß und ohne ausstehende Transaktionen heruntergefahren
wird. Andernfalls führt der Anwendungsserver beim Neustart eine
Wiederherstellung durch und lädt dazu alle erforderlichen RAR-Dateien und nativen Bibliotheken. Versuchen Sie nicht, nach einer solchen
Wiederherstellung, anwendungsbezogene Arbeitsschritte auszuführen. Fahren Sie den Server herunter, und starten Sie ihn neu.
Der Anwendungsserver
versucht bei diesem Neustart keine erneute Wiederherstellung, sodass Sie mit der normalen Anwendungsverarbeitung
fortfahren können.