Verwenden Sie den Aktualisierungsassistenten für
Ressourcenadapterarchive (RAR), um eigenständige RAR-Dateien auf eine neuere Version zu aktualisieren.
Der Anwendungsserver verwendet die Klassen und anderen Code, der ein Ressourcenadapterarchiv für
die Unterstützung der zu konfigurierenden Ressourcenadapter enthält.
Vorbereitende Schritte
Ein Ressourcenadapter muss auf dem Anwendungsserver installiert sein und
eine neue Version des Ressourcenadapters,
die mit der alten Version kompatibel ist, muss vorhanden sein.
Sie können die RAR-Datei mit einem Assembliertool erstellen, oder die neue Version vom
Anbieter des Ressourcenadapters erhalten.
Ist die neue Version der RAR-Datei nicht mit der alten Version des Ressourcenadapters
kompatibel, ist keine Aktualisierung möglich.
Die Spezifikation
Java™ Connector Architecture
(JCA) Version 1.6 fügt die Unterstützung für
Java-Annotationen in RAR-Modulen hinzu.
Weitere Informationen
zur Unterstützung für Annotationen finden Sie im Artikel zur JCA-1.6-Unterstützung für Annotationen in RAR-Modulen.
Informationen zu diesem Vorgang
Aktualisieren Sie eine RAR-Datei, wenn Sie ein Ressourcenadapter oder eine
Gruppe von Ressourcenadaptern auf eine anderen Version aktualisiert werden muss.
Unterschiedliche Versionen von Ressourcenadaptern können unterschiedliche Einstellungen enthalten.
Eine Aktualisierung Ihres Adapters kann also hilfreich sein, wenn Sie bestimmte Konfigurationsoptionen benötigen.
Sie können wählen, ob der Ressourcenadapter für alle Knoten in einer Zelle oder für alle Knoten in einem Cluster
aktualisiert werden soll.
Wenn einige Knoten eine ältere Version als
Version 7.0 haben, wird die RAR-Aktualisierung auf diesen Knoten erst dann unterstützt, wenn sie
auf Version 7.0 migriert wurden. Aktualisierungen für Adapter der JCA Version 1.6 werden nur auf Knoten
der Version 9.0 unterstützt.
Wenn mehrere Versionen eines Ressourcenadapters in einer
Java Virtual Machine (JVM) aktiv sein sollen, bietet der Aktualisierungsassistent nicht die Möglichkeit,
eine weitere Version zu erstellen und die alte Version beizubehalten.
Sie müssen in diesem Fall einen isolierten Ressourcenadapter erstellen und entsprechend konfigurieren.
Weitere Informationen finden Sie im Artikel zum Konfigurieren eines Ressourcenadapters.
Vorgehensweise
- Sichern Sie alle Konfigurationsänderungen.
- Sichern Sie Ihre Konfigurationsänderungen mit dem Tool
"backupConfig". Das Tool "backupConfig" befindet sich im Verzeichnis
Application Server-Stammverzeichnis/bin. Weitere
Informationen zur Verwendung dieses Befehls finden Sie im Artikel zum Befehl "backupConfig".
- Synchronisieren Sie alle Knoten, die aktualisiert werden sollen.
- Vergewissern Sie sich, dass die Node Agents aktiv sind, falls Sie
den zu aktualisierenden Ressourcenadaptern zugeordnet sind.
- Stoppen Sie alle Server, die die RAR-Datei enthalten, die Sie aktualisieren.
Sie müssen alle Server in dem Knoten oder Cluster, dem die RAR-Datei zugeordnet ist, stoppen.
Informationen zum Stoppen oder Starten eines Anwendungsservers finden Sie im Artikel "Anwendungen
und ihre Umgebung verwalten".
- Klicken Sie auf .
- Aktivieren Sie das Kontrollkästchen neben der RAR-Datei, die aktualisiert werden soll, und klicken Sie auf
RAR aktualisieren.
- Geben Sie den Installationspfad für die RAR-Datei an, und klicken Sie auf
Weiter.
- Wenn sich die RAR-Datei auf derselben Workstation befindet wir Ihr Browser, wählen Sie
Lokales Dateisystem aus, und suchen Sie die Datei.
- Wenn sich die RAR-Datei auf der Server-Workstation befindet, auf der der Anwendungsserver installiert ist,
wählen Sie
Fernes Dateisystem aus, und geben Sie den vollständig qualifizierten Pfad zur Datei an.
- Prüfen Sie die für die RAR-Datei angegebenen Konfigurationsdaten. Folgende Informationen werden für die RAR-Datei angezeigt:
- Name
- Aktuelle RAR-Version
- Neue RAR-Version
- Geltungsbereich
- Vorhandene Kopien des Ressourcenadapters. Die mit einem Stern
(*) gekennzeichneten Ressourcenadapter sind Kopien des Ressourcenadapters und müssen gleichzeitig aktualisiert werden.
Klicken Sie anschließend auf Weiter.
- Optional: Editieren Sie die Eigenschaften, die von der neuen Version des Ressourcenadapters hinzugefügt wurden.
Sie können diese Eigenschaften auch nach Beendigung der Aktualisierung editieren.
- Wählen Sie eine Ressource in der Liste aus, um die neuen Eigenschaften zu editieren. Nur Ressourcen mit neuen Eigenschaften werden in die Liste aufgenommen.
- Editieren Sie die Ressourceneigenschaften. Verwenden Sie die bereitgestellte Tabelle, um die Werte für die neuen Eigenschaften der ausgewählten Ressource festzulegen.
- Aktivieren Sie das Kontrollkästchen
Für alle festlegen, um den Eigenschaftswert auf alle Ressourcen desselben Typs anzuwenden.
- Klicken Sie auf die Schaltfläche
Auf Standardwerte zurücksetzen, um alle Eigenschaften auf die in der RAR-Datei definierten
Standardwerte zurückzusetzen.
Diese Eigenschaft gilt nur für die ausgewählte Ressource.
- Klicken Sie auf Weiter.
- Prüfen Sie die Zusammenfassungsanzeige und klicken Sie auf
Fertig stellen, wenn die richtigen Konfigurationseinstellungen angezeigt werden. Wenn Sie auf "Fertig stellen" klicken, werden alle Konfigurationsänderungen automatisch gesichert.
Um zu einer älteren Version des Ressourcenadapters zurückzukehren, müssen Sie den Aktualisierungsprozess
erneut ausführen und dabei die ältere Version der RAR-Datei angeben.
- Starten Sie die Server erneut, die die aktualisierte RAR-Datei enthalten.
Nächste Schritte
Wenn Sie mit den Ergebnissen nicht zufrieden sind und Ihre Konfiguration mit dem Tool
"backupConfig" gesichert haben, verwenden Sie das Tool
"restoreConfig", um die Sicherungskonfiguration wiederherzustellen. Weitere Informationen zur Verwendung dieses Befehls
finden Sie im Artikel zum Befehl "restoreConfig".