Besonderheiten im Cluster-Betrieb

In einer Cluster-Umgebung (s. a.  BeanConnect im Cluster-Betrieb) 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.

• Cluster-Betrieb und Multi-Resource Adapter Betrieb schließen sich gegenseitig aus.
• Für den Cluster-Betrieb muss der BeanConnect Proxy immer als Proxy Cluster konfiguriert werden, selbst wenn nur ein Proxy Knoten verwendet wird.

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.

Wenn Sie diese Property nicht über die Management Console sondern manuell ändern, müssen Sie beachten, dass Sie für jede Resource Adapter Adresse außer der ersten, die sie mit der Property resourceAdapterAddresses konfigurieren, 1000 USER Anweisungen USER BCUij000 bis USER BCUij999 in der Datei input.own im Proxy-Container Verzeichnis <Proxy_home>/def hinzufügen müssen, z.B. für die 12te Resource Adapter Adresse müssen Sie die USER Anweisungen USER BCU12000 bis USER BCU12999 hinzufügen.

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>

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.