Resource Adapter im Cluster-Betrieb hinzufügen

Sie fügen einen Resource Adapter im Cluster-Betrieb hinzu, indem Sie im Cluster-Teilbaum des Navigationsbaums das Kontextmenü des Knotens Resource Adapters öffnen und den Befehl Add Resource Adapter.. wählen. Alternativ können Sie auch auf den gewünschten Knoten klicken und in der Liste der Resource Adapter den Befehl Add ausführen.

Tragen Sie die Parameter des Resource Adapters in die beiden Registerblätter General und Common Properties ein. Die Parameter in Common Properties sind für alle Resource Adapter eines Clusters gleich, eine Änderung bei diesen Properties wirkt sich deshalb auf alle definierten Resource Adapter des Cluster aus, während die Parameter in General Resource Adapter spezifisch sind:

Bild 27: Hinzufügen eines Resource Adapters im Cluster-Betrieb

Host (General)

Name oder IPv4-Adresse des Rechners, auf dem der Application Server läuft, in dem der Resource Adapter deployt ist. Der Host muss dem Wert <host> in einem Eintrag <host:port> in der Property resourceAdapterAddresses im Deployment Descriptor ra.xml des Resource Adapters entsprechen.

Listener Port (General)

Listener Portnummer des Resource Adapters für Inbound-Kommunikation. Der in Host angegebene Host und der Listener Port müssen einem Eintrag <host:port> in der Property resourceAdapterAddresses im Deployment Descriptor ra.xml des Resource Adapters entsprechen. Ist dort kein Port angegeben, muss Angabe mit dem Wert in der Property inboundListenerPort übereinstimmen.

i	Innerhalb des Clusters erlaubt die Management Console weder den Wert 0 noch eine Leereingabe. Es muss immer ein Port von 1025 bis 65535 angegeben werden, auch dann, wenn kein Inbound geplant ist.

MC-CmdHandler of the Resource Adapter (General)

In diesen Feldern können Sie einen MC-CmdHandler definieren, der auf dem Rechner des Resource Adapters verfügbar ist und über den der Deployment Descriptor ra.xml des Resource Adapters per Management Console angepasst werden kann:

• Mit der Schaltfläche ... bei Select MC-CmdHandler erhalten Sie einen Folgedialog, in dem Sie die Daten des MC-CmdHandler eingeben (Rechner, Listener Port, Passwort).

  Wenn sich das BeanConnect-RAR-Archiv auch auf diesem Rechner befindet, können Sie über diesen MC-CmdHandler die Einträge im Deployment Descriptor ra.xml des Resource Adapters editieren oder gemäß der eingegebenen Parameter aktualisieren. Dazu verwenden Sie die Befehle Edit ra.xml of BeanConnect Resource Adapter RAR oder Update ra.xml of BeanConnect Resource Adapter RAR im Kontextmenü des Resource Adapters, siehe Konfigurationsdatei des Resource Adapters . Außerdem lassen sich über diesen MC-CmdHandler die Log4j-Diagnoseeinstellungen ändern.
   

• In Log4j Configuration File Path können Sie den kompletten Pfadnamen der Log4j Konfigurationsdatei angeben (optional).

  Die Log4j-Konfigurationsdatei liegt immer auf dem Rechner, auf dem der Application Server läuft. Dies muss nicht der Rechner sein, auf dem sich der BeanConnect Resource Adapter befindet, da der Resource Adapter auch erst beim Deployment auf den Rechner des Application Servers hochgeladen werden kann.

  Wenn man die Logging-Konfiguration des Resource Adapters ändern will, muss auch auf dem Rechner, auf dem der Application Server läuft, ein MC-CmdHandler laufen.

Transaction Logging (Common Properties)

Gibt an, ob bei Outbound-Kommunikation persistente Transaktions-Logs im Resource Adapter geschrieben wird (Auswahl FILE) oder nicht (Auswahl NONE). Diese Eigenschaft entspricht der Property transactionLogging im Deployment Descriptor ra.xml des Resource Adapters. Bei konfiguriertem Transaktions-Logging schreibt der Resource Adapter für jede Transaktion eine eigene Log-Datei. Der Dateiname setzt sich zusammen aus dem Prefix tx. und einer Nummer.

Transaction Logging Directory (Common Properties)

Verzeichnis, unter dem das Logging der Transaktionen im Resource Adapter angelegt wird. Diese Eigenschaft entspricht der Property transactionLogDir im Deployment Descriptor ra.xml des Resource Adapters.

Proxy Reconnect Count (Common Properties)

Gibt an, nach wieviel Verbindungsanforderungen (getConnection()-Aufrufen) eine Neuzuordnung zwischen Resource Adapter Instanz und Proxy-Anwendung initiiert werden soll. Diese Eigenschaft regelt die nutzungsabhängige Neuzuordnung einer Resource Adapter Instanz zu einer Proxy-Anwendung. Sie entspricht der Property proxyReconnectCount im Deployment Descriptor ra.xml des Resource Adapters.

Der voreingestellte Wert ist 100.

Wenn ein Cluster mit mehr Resource Adapter Instanzen als Proxy Instanzen betrieben wird, dann sollte für diesen Parameter ein größerer Wert oder der Wert 0 eingetragen werden; mit dem Wert 0 wird der Reconnect Counter ausgeschaltet.

Proxy Reconnect Interval (min) (Common Properties)

Gibt an, nach wie vielen Minuten eine Neuzuordnung zwischen Resource Adapter Instanz und Proxy-Anwendung initiiert werden soll. Diese Eigenschaft regelt die zeitabhängige Neuzuordnung einer Resource Adapter Instanz zu einer Proxy-Anwendung, Sie entspricht der Property proxyReconnectInterval im Deployment Descriptor ra.xml des Resource Adapters.

Der voreingestellte Wert ist 10 Minuten.

Wenn ein Cluster mit mehr Resource Adapter Instanzen als Proxy Instanzen betrieben wird, dann sollte für diesen Parameter ein größerer Wert oder der Wert 0 eingetragen werden; mit dem Wert 0 wird der Reconnect Timer ausgeschaltet.