Besonderheiten im Cluster-Betrieb

In einer Cluster-Umgebung können sowohl mehrere Resource Adapter Instanzen als auch mehrere Proxy Instanzen zum Ablauf kommen. Die Anzahl der Proxy Instanzen muss nicht gleich der Anzahl der Resource Adapter Instanzen sein. Es sind maximal 32 Resource Adapter Instanzen und maximal 32 Proxy Instanzen möglich.

Alle beteiligten Instanzen sind identisch konfiguriert, insbesondere wird jede Resource Adapter Instanz mit dem gleichen BeanConnect-RAR-Archiv deployt und arbeitet daher auch mit den gleichen Konfigurationswerten aus ra.xml.

Cluster-Betrieb ist für Outbound-Kommunikation über OSI TP / LU6.2 und für Inbound-Kommunikation möglich.

Im Application Server sind bei Cluster-Betrieb folgende Konfigurationsschritte nötig:

• Definieren Sie in der Datei ra.xml die zusätzlichen Parameter und Properties für den Cluster-Betrieb:

  • In der Property proxyURL müssen Sie die Adressen aller Proxy Instanzen angeben.

  • In der zusätzlichen Property resourceAdapterAddresses müssen Sie die Adressen aller Resource Adapter Instanzen angeben.

  • In den Properties proxyReconnectCount und proxyReconnectInterval können Sie die Parameter für Neuzuordnung von Resource Adapter und Proxy ändern.

  Dies ist wie beim Standard-Betrieb über die Management Console möglich, siehe „ra.xml anpassen“ im Allgemeine Eigenschaften in ra.xml festlegen . Sie können die Datei ra.xml aber auch manuell anpassen.

• Führen Sie die anderen Konfigurationsschritte im Application Server genauso aus wie beim Betrieb mit nur einem Resource Adapter, siehe Konfigurationsschritte für Outbound- und Inbound-Kommunikation .

proxyURL

Die proxyURL legt im Cluster-Betrieb die Zuordnung der Resource Adapter Instanzen zu den Proxy Instanzen fest. Wenn mit mehreren Proxy Instanzen gearbeitet wird, dann müssen die Adressen aller Proxys angegeben werden, jeweils getrennt durch ein Semikolon.

Definition:	oltp://<host>:<port>/<name>; ... ;oltp://<host>:<port>/<name>
Erklärung:	<host>	Rechner, auf dem der betreffende Proxy-Container installiert ist.<host> kann als symbolischer Name oder als IPv4-Adresse angegeben werden.
	<port>	Portnummer des betreffenden Proxy-Containers + 4
	<name>	Anwendungsname des betreffenden Proxy-Containers (BCU<port>)
	Die einzelnen Einträge müssen durch Semikolon getrennt sein.
Standard:	oltp://localhost:31004/BCU31004
Beispiel:	<config-property> <description>BeanConnect Proxy URLs for OLTP outbound communication with 2 Proxies</description> <config-property-name>proxyURL</config-property-name> <config-property-type>java.lang.String </config-property-type> <config-property-value>oltp://proxyhost1:31004/BCU31004; oltp://proxyhost2:31014/BCU31014 </config-property-value> </config-property>

resourceAdapterAddresses

Diese Property ist nur in einer Cluster-Konfiguration mit mehreren Resource Adapter Instanzen von Bedeutung und darf nicht zusammen mit der Property resourceAdapterIndex angegeben werden (siehe Besonderheiten im Multi-Resource Adapter Betrieb ).

Mit dieser Property werden die Adressen aller Rechner definiert, auf denen Instanzen des BeanConnect Resource Adapters zum Ablauf kommen. Sie können maximal 32 Adressen angeben, die Einträge müssen durch ein Semikolon getrennt sein.

Die Adressen geben Sie in der Form host[:port] an. Wenn Sie keine Portnummer angeben, dann wird die Portnummer der Property inboundListenerPort als Listener Port für die Inbound-Kommunikation verwendet, diese muss dann größer 0 sein. Wenn Sie eine Portnummer angeben, dann wird diese als Listener Port für die Inbound-Kommunikation verwendet, sie muss größer 0 sein.

Wenn unter einer Host-Adresse mehrere Resource Adapter Instanzen ablaufen sollen, dann müssen Sie diese Host-Adresse entsprechend oft in der Liste angeben und mit unterschiedlichen Portnummern versehen.

Definition:	<host>[:<port>]; ... ;<host>[:<port>]
Erklärung:	<host>	Rechner, auf dem die betreffende Resource Adapter Instanz abläuft. <host> kann als symbolischer Name oder als IPv4-Adresse angegeben werden.
	<port>	Portnummer der betreffenden Resource Adapter Instanz für Inbound-Kommunikation.
	Die einzelnen Einträge müssen durch Semikolon getrennt sein.
Standard:	Es gibt keinen Standardwert.
Beispiel:	<config-property> <config-property-name>resourceAdapterAddresses </config-property-name> <config-property-type>java.lang.String </config-property-type> <config-property-value> host1:31099;host2:31099;host3:31099 </config-property-value> </config-property>

proxyReconnectCount

Diese Property ist nur in einer Cluster-Konfiguration mit mehreren Resource Adapter Instanzen und mehreren Proxy Instanzen von Bedeutung. proxyReconnectCount regelt die nutzungsabhängige Neuzuordnung einer Resource Adapter Instanz zu einer ProxyAnwendung. Dieser Mechanismus wird aktiviert, sobald einer Proxy-Anwendung mehrere Resource Adapter Instanzen zugeordnet sind.

Definition:	<number>
Erklärung:	<number> gibt an, nach wie vielen Verbindungsanforderungen (getConnection()-Aufrufen) eine Neuzuordnung zwischen Resource Adapter Instanz und Proxy-Anwendung initiiert werden soll. Wird für <number> der Wert 0 angegeben, dann ist die nutzungsabhängige Neuzuordnung deaktiviert.
Standard:	100
Beispiel:	<config-property> <config-property-name>proxyReconnectCount </config-property-name> <config-property-type>java.lang.String </config-property-type> <config-property-value>200 </config-property-value> </config-property>

proxyReconnectInterval

Diese Property ist nur in einer Cluster-Konfiguration mit mehreren Resource Adapter Instanzen und mehreren Proxy Instanzen von Bedeutung. proxyReconnectInterval regelt die zeitabhängige Neuzuordnung einer Resource Adapter Instanz zu einer ProxyAnwendung. Dieser Mechanismus wird aktiviert, sobald einer Proxy-Anwendung mehrere Resource Adapter Instanzen zugeordnet sind.

Definition:	<minutes>
Erklärung:	<minutes> gibt an, nach wie vielen Minuten eine Neuzuordnung zwischen Resource Adapter Instanz und Proxy-Anwendung initiiert werden soll. Wird für <minutes> der Wert 0 angegeben, dann ist die zeitabhängige Neuzuordnung deaktiviert.
Standard:	10
Beispiel:	<config-property> <config-property-name>proxyReconnectInterval </config-property-name> <config-property-type>java.lang.String </config-property-type> <config-property-value>5 </config-property-value> </config-property>

i

Wird eine Cluster-Konfiguration mit mehr Resource Adapter Instanzen als Proxy Instanzen betrieben (d.h. mindestens einer Proxy Instanz ist immer mehr als eine Resource Adapter Instanz zugeordnet), dann sollten aus Performance-Gründen die nutzungsabhängige und die zeitabhängige Neuzuordnung ausgeschaltet oder zumindest größere Werte als die Standardwerte eingestellt werden.