Eigenständiges Ressourcenadapterarchiv aktualisieren

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

  1. Sichern Sie alle Konfigurationsänderungen.
  2. 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".
  3. Synchronisieren Sie alle Knoten, die aktualisiert werden sollen.
  4. Vergewissern Sie sich, dass die Node Agents aktiv sind, falls Sie den zu aktualisierenden Ressourcenadaptern zugeordnet sind.
  5. 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".

  6. Klicken Sie auf Ressourcen > Ressourcenadapter > Ressourcenadapter.
  7. Aktivieren Sie das Kontrollkästchen neben der RAR-Datei, die aktualisiert werden soll, und klicken Sie auf RAR aktualisieren.
  8. 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.
  9. 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.
  10. 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.
    1. 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.
    2. 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.
    3. Klicken Sie auf Weiter.
  11. 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.
  12. 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".

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=tdat_upgradeRAR
Dateiname:tdat_upgradeRAR.html