Sie fügen einen Resource Adapter hinzu, indem Sie im Proxy-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. Der Proxy darf beim Hinzufügen nicht gestartet sein, daher müssen Sie ihn vorher ggf. beenden, z.B. mit dem Befehl Stop Proxy im Kontextmenü des Proxys.
Tragen Sie die Parameter des Resource Adapters in das Registerblatt General ein:
Bild 25: Hinzufügen eines Resource Adapters ohne Cluster-Betrieb
Name
Frei wählbarer Name des Resource Adapters. Dieser Name ist nur innerhalb der Management Console von Bedeutung.
ID / Index
ID ist eine von der Management Console vergebene ID des Resource Adapters. Diese ist eine Zahl zwischen 1 und 256.
Index ist der Index des Resource Adapters, er wird von der Management Console vergeben. Der Index ist nur im Multi-Resource Adapter Betrieb relevant. Diese Eigenschaft entspricht der Property resourceAdapterIndex im Deployment Descriptor ra.xml des Resource Adapters.
Description
Hier können Sie eine frei wählbare Beschreibung des Resource Adapters eintragen.
Host
Name oder IPv4-Adresse des Rechners, auf dem der Application Server läuft, in dem der Resource Adapter deployt ist.
Listener Port
Listener Portnummer des Resource Adapters für Inbound-Kommunikation. Diese Eigenschaft entspricht der Property inboundListenerPort im Deployment Descriptor ra.xml des Resource Adapters. Wenn Sie hier 0 eintragen, dann sind für diesen Resource Adapter weder Inbound-Kommunikation noch Verfügbarkeitsprüfung möglich.
Proxy URL of OLTP Outbound Communication
URL, die bei der Outbound-Kommunikation im Application Server verwendet wird. Diese URL wird beim Konfigurieren des Proxy festgelegt und ist nicht änderbar. Diese Eigenschaft entspricht der Property proxyURL im Deployment Descriptor ra.xml des Resource Adapters.
Transaction Logging
Gibt an, ob bei Outbound-Kommunikation persistente Transaktions-Logs im Resource Adapter geschrieben werden (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
Verzeichnis, unter dem die Transaktions-Logs im Resource Adapter angelegt werden. Diese Eigenschaft entspricht der Property transactionLogDir im Deployment Descriptor ra.xml des Resource Adapters.
MC-CmdHandler of the Resource Adapter
Hiermit können Sie einen MC-CmdHandler definieren, der auf dem Rechner des Resource Adapters verfügbar ist und über den der Resource Adapter per Management Console administriert werden kann. Dazu gehen Sie wie folgt vor:
Mit der Schaltfläche ... bei Select MC-CmdHandler erhalten Sie den Folgedialog Properties of MC-CmdHandler, in dem Sie die Daten des MC-CmdHandler eingeben (Listener Port, Passwort):
Bild 26: Eigenschaften eines MC-CmdHandlers konfigurieren
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 Log4jKonfigurationsdatei 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.