Konfigurationsparameter des Proxy-Servlets

Damit Sie das Proxy-Servlet web.xml im Servlet-Container implementieren können, müssen Sie es mit den folgenden Initialisierungsparametern für die Brokerumgebung konfigurieren, mit der das Servlet eine Verbindung herstellt.

Dieses Thema enthält folgende Abschnitte:

Allgemeine Optionen

Parametername Standardwert Beschreibung
Brokername

* (automatische Erkennung auf Basis der Konfigurationsdaten für Broker)

Brokername oder “*”

Damit kann der für Fehlernachrichten verwendete Name festgelegt werden; der Wert wird bei Angabe von "*" automatisch erkannt.

Legen Sie einen Wert fest, wenn mehrere Broker im Proxy-Verfahren weitergeleitet werden und für die Fehlernachrichten ein einzelner Name erforderlich ist.

configFilePath

/var/mqsi/components/MB8BROKER/config/wsplugin6.conf

vollständiger Pfad der Konfigurationsdatei

Wenn es sich beim Proxy-Broker um einen lokalen Broker handelt, setzen Sie diesen Parameter für den Broker auf die Datei wsplugin6.conf (bei HTTP-Knoten) oder soapplugin6.conf (bei SOAP-Knoten).

Diese Datei wird nur verwendet, wenn der Parameter useQueueManagerDataInsteadOfConfigFile nicht belegt ist. Die Konfigurationsdatei kann nur verwendet werden, wenn das Proxy-Servlet auf demselben Server wie der Broker ausgeführt wird und auf die Datei zugreifen kann.

Unter Windows befindet sich die Datei in C:\Installationsverzeichnis\config\wsplugin.conf oder C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\components\Brokername\config\wsplugin6.conf.

Unter Linux und UNIX befindet sich die Datei in /var/mqsi/config/wsplugin.conf oder in /var/mqsi/components/Brokername/config/wsplugin6.conf.

useFastpathBindingsConnection

false

true oder false

Bewirkt, dass das Servlet im Fastpath-Modus eine Verbindung herstellt, wenn ein lokaler WS-Manager verwendet wird.

traceFileName  

vollständiger Pfad der Tracedatei

Geben Sie den Pfad und Namen der Tracedatei an. Wird dieser Parameter nicht angegeben, wird der Trace an die Standardausgabe (stdout) gesendet.

turnTraceOn

0

0, 1 oder 2

0 steht für keinen Trace, 1 für einen normalen Trace, 2 für Debugging.

Informationsoptionen

Parametername Standardwert Beschreibung
enableStatusPage

(WebSphere Message Broker V6.1 FP 4 oder höher)

false

true oder false

Wechselt die Anzeige der Statusseite. Bei der Angabe von 'true' kann die Seite unter folgender Adresse angezeigt werden: http://Hostname:Port/Proxy-Kontext/messagebroker/httpproxy/statuspage

enableInfoHeaders

(WebSphere Message Broker V6.1 FP 4 oder höher)

false

true oder false

Bewirkt, dass vom Servlet zusätzliche Header in der Antwort hinzugefügt werden. Hierbei handelt es sich um folgende Header:

X-WMB-Broker-Name

X-WMB-QM-Name

X-WMB-MQ-URL-CorrelId

Dabei sind Einzeldaten der für diese Nachricht verwendeten Konfiguration enthalten.

ReplyToQ- und QMgr-Optionen

Parametername Standardwert Beschreibung
useClusterMode

false

true oder false

Setzen Sie diese Option auf 'true', wenn das Servlet Informationen über die Empfangswarteschlange für Antworten und den WS-Manager in den MQMD der gesendeten Nachrichten stellen soll, damit der Broker dem richtigen WS-Manager in einem Cluster antworten kann.

clusterModeQueueManagerName

SOME_OTHER_ QUEUE_MANAGER

Name des WS-Managers

Name des WS-Managers für die Anfangseinstellung von MQCONN und ReplyToQMgr.

clusterModeReplyToQ

OUR.REPLYTO.QUEUE

Name der Warteschlange für Antwortnachrichten

Name der Warteschlange, die überwacht werden soll.

SSL-Verbindungsoptionen

Parametername Standardwert Beschreibung
useSecuredChannel

false

true oder false

Setzen Sie den Wert von useSecuredChannel auf true, wenn SSL auf dem MQ-Kanal konfiguriert ist. Bei Angabe von true versucht das Servlet, anhand der Parameterwerte keyStore, keyStorePassword, trustStore, trustStorePassword und cipherSuite eine gesicherte Verbindung mit dem MQ-Kanal herzustellen.

keyStore

vollständiger Pfad der Schlüsselspeicherdatei

Der vollständig qualifizierte Pfad der Schlüsselspeicherdatei mit dem Typ 'JKS'.

Beispiel für Windows: C:\\Programme\\IBM\\MQSI\\keystore.jks

Unter Linux und UNIX: /var/mqsi/keystore.jks

keyStorePassword

changeit

Das Kennwort für die Schlüsselspeicherdatei.

trustStore  

vollständiger Pfad der Truststore-Datei

Der vollständig qualifizierte Pfad der Truststore-Datei mit dem Typ 'JKS'.

Beispiel für Windows: C:\\Programme\\IBM\\MQSI\\truststore.jks

Unter Linux und UNIX: /var/mqsi/truststore.jks

Dies Feld ist obligatorisch, wenn useSecuredChannel auf true gesetzt ist.
trustStorePassword

changeit

Das Kennwort für die Truststore-Datei.

cipherSuite  

Der Verschlüsselungstyp, der im MQ-Kanal konfiguriert ist. Beispiel: SSL_RSA_WITH_NULL_MD5 Dieses Feld ist obligatorisch, wenn useSecuredChannel auf true gesetzt ist.

MQ-Verbindungsoptionen

Parametername Standardwert Beschreibung
useClientMode

false

true oder false

Sie können den WebSphere MQ-Client verwenden (true) oder die Binding-Verbindung (false). Wenn dieser Parameter auf 'true' gesetzt wird, wird die Option useQueueManagerDataInsteadOfConfigFile für gewöhnlich auf den Warteschlangenmanager des Brokers gesetzt.

clientModeHostname

localhost

Hostname oder IP-Adresse

Hostname oder IP für den WS-Manager.

clientModeChannelName

SYSTEM.DEF. SVRCONN

Name des WebSphere MQ-SVRCONN-Kanals

Der Name des zu verwendenden SVRCONN-Kanals von WebSphere MQ.

clientModePortNumber

1414

Portnummer

Die Portnummer des WebSphere MQ-Empfangsprogramms.

clientModeConnectRetryCount

(WebSphere Message Broker V6.1 FP 4 oder höher)

1

Ganzzahl

Gibt an, wie oft der WebSphere MQ-Verbindungsaufruf wiederholt werden soll. Dieser Parameter ist hilfreich, wenn die Arbeit über einen Netzdispatcher oder eine Lastausgleichsfunktion an eine Gruppe von WS-Managern verteilt wird und einer davon fehlschlägt. Eine neue Verbindung kann das erste Mal fehlschlagen, beim zweiten Mal jedoch erfolgreich sein. Der Wiederholungszähler muss auf einen hohen Wert gesetzt werden, um die Erfolgswahrscheinlichkeit zu erhöhen.

useQueueManagerDataInsteadOfConfigFile  

Name des WS-Managers, “*” oder keine Angabe

Der Name des WS-Managers, ‘*' (ferner Proxy) oder keine Angabe (lokaler Proxy).

Diese Option bewirkt, dass das Servlet Webadressdaten aus einer Warteschlange liest; es muss also keine Konfigurationsdatei über das Servlet zugänglich sein.

sleepBeforeGet

0

Zeit in Sekunden

Ruhezeit in Sekunden. Das Servlet wartet in diesem Fall auf eine Antwortnachricht vom Broker, bevor ein MQGET-Aufruf ausgegeben wird.

disconnectBeforeSleep

true

true oder false

Der WebSphere MQ-Handle wird im Ruhemodus freigegeben. Mithilfe dieser Option kann die Anzahl der gleichzeitig bestehenden WebSphere MQ-Verbindungen niedrig gehalten werden.

reconnectActiveLinksAge

(WebSphere Message Broker V6.1 FP 4 oder höher)

-1

Zeit in Sekunden, 0 oder -1

Wenn dieser Parameter auf einen höheren Wert als null gesetzt wird, werden die WebSphere MQ-Verbindungen getrennt und erneut hergestellt, wenn sie aufgrund eines geringen Datenverkehrs länger als eine bestimmte Anzahl von Sekunden inaktiv waren.

Wird dieser Parameter auf -1 gesetzt, erfolgt kein erneuter Verbindungsaufbau. Bei einer Festlegung auf 0 werden alle Verbindungen nur einmal genutzt.

Dieser Parameter ist besonders nützlich, wenn die Verbindung mit WebSphere MQ über eine Firewall verläuft, die Verbindungen nach einem bestimmten Inaktivitätszeitraum schließt.

Wird dieser Parameter auf einen Wert gesetzt, der unter dem Firewall-Zeitlimit liegt, kann möglicherweise vermieden werden, dass Clients Fehler des Typs WebSphere MQ 2009 (unterbrochene Verbindung) erhalten.

testConnectionBeforeReuse

(WebSphere Message Broker V6.1 FP 4 oder höher)

false

true oder false

Wird diese Option auf 'true' gesetzt, versucht das Servlet einen MQINQ-Aufruf, bevor der MQPUT-Vorgang der HTTP-Datennachricht erfolgt. Zu diesem Zeitpunkt werden eventuell bestehende Probleme mit einer zwischengespeicherten WebSphere MQ-Clientverbindung erkannt und eine neue Verbindung wird für den MQPUT-Vorgang der eigentlichen Daten (und den MQGET-Vorgang der Antwort) hergestellt.

Da dieser Parameter den Datenaustausch im Netz beträchtlich erhöht, darf er nur verwendet werden, wenn Probleme im Zusammenhang mit gelöschten Verbindungen auftreten. Diese werden für gewöhnlich als WebSphere MQ-Fehler des Typs 2009 angezeigt und weisen auf unterbrochene Verbindungen hin.

maximumConnectionAge

(WebSphere Message Broker V6.1 FP 6 oder höher)

-1

Zeit in Sekunden, 0 oder -1

Wenn dieser Parameter auf einen höheren Wert als null gesetzt wird, werden die WebSphere MQ-Verbindungen getrennt und erneut hergestellt, wenn sie älter als eine bestimmte Anzahl von Sekunden sind.

Wird dieser Parameter auf -1 gesetzt, werden diese erneuten Verbindungsherstellungen verhindert. Wenn Sie diesen Parameter auf 0 setzen, werden alle Verbindungen nur einmal verwendet.

Dieser Parameter ist vor allem dann nützlich, wenn die WebSphere MQ-Verbindungsparameter aufgrund von erneuten Implementierungen der WebSphere Message Broker-Flüsse voraussichtlich häufig geändert werden und diese Änderungen innerhalb der festgelegten Anzahl an Sekunden von ProxyServlet reflektiert werden müssen.

Sie können eine oder mehrere Zuordnungen definieren, die vom Proxy-Servlet unterstützt werden. Diese Zuordnungen werden vom Servlet-Container für das Filtern von Webadressanforderungen verwendet, bevor die richtige Instanz des Proxy-Servlets ausgeführt wird.

Bei den Zuordnungen handelt es sich um Pfade des Typs /Knoten-URL-Pfad, die in folgendem Abschnitt beschrieben werden: HTTP-Proxy-Servlet - Komponente 'Webadressen' (/URL-Pfad=/Kontextstammverzeichnis/Knoten-URL-Pfad).

Sie können einen /Knoten-URL-Pfad definieren, der "/*" entspricht, um Webadresspfade zu akzeptieren, die folgendem Beispiel ähneln: /HTTPMyBrkServletProxy/Ihr_Wert.

Beispielszenarios der Konfiguration:

  • Szenario 1: Der Web-Servlet-Container befindet sich auf demselben Server wie WebSphere Message Broker:

    In diesem Konfigurationsbeispiel müssen useClientMode und useQueueManagerDataInsteadOfConfigFile auf 'false' gesetzt werden und der Parameter configFile muss auf eine gültige Datei zeigen. Das Servlet versucht, für den Broker eine Verbindung zum lokalen WS-Manager herzustellen, nachdem es den Namen des WS-Managers in der Konfigurationsdatei gelesen hat.

  • Szenario 2: Der Web-Servlet-Container befindet sich auf einem anderen Server als WebSphere Message Broker mit einer WebSphere MQ-Clientverknüpfung zum Warteschlangenmanager des Brokers:

    In diesem Konfigurationsbeispiel müssen Sie useClientMode auf 'true', useQueueManagerDataInsteadOfConfigFile auf "*" oder den Namen des Warteschlangenmanager des Brokers und clientModeHostname, clientModeChannelName sowie clientModePortNumber auf die jeweils richtigen Werte setzen, die in diesem Bereich definiert werden. Das Servlet versucht, für den Broker eine Verbindung zum fernen WS-Manager herzustellen und liest dabei die erforderlichen Daten der Knotenkonfiguration aus dem Broker über die WebSphere MQ-Clientverbindung.

    Die Konfigurationsdatei kann auch aus dem Brokerserver in den Server des Web-Servlet-Containers kopiert und anschließend die Option configFile genutzt werden. Zuvor müssen Sie sicherstellen, dass die Option useQueueManagerDataInsteadOfConfigFile nicht belegt wurde, damit das Lesen von Daten aus der Konfigurationsdatei erzwungen wird. Die Konfigurationsdatei muss jedoch bei jeder Änderung durch den Broker erneut kopiert werden.

  • Szenario 3: Der Web-Container befindet sich auf einem anderen Server als WebSphere Message Broker mit einem eigenen WS-Manager und einer WebSphere MQ-Clientverknüpfung zum Warteschlangenmanager des Brokers:

    Dieses Konfigurationsszenario ähnelt dem Szenario 1, da der Clientmodus nicht verwendet wird. Die Option useClusterMode muss jedoch auf 'true', clusterModeQueueManagerName auf den WS-Manager für Web-Servlet-Container und clusterModeReplyToQ auf eine Warteschlange gesetzt werden, die in diesem WS-Manager vorhanden ist.

    Das Servlet versucht, die Warteschlange SYSTEM.BROKER.WS.INPUT im angegebenen Warteschlangenmanager zu öffnen und verwendet dabei den Namen des WS-Managers aus der Konfigurationsdatei. Daher müssen Sie zuerst Kanäle und Übertragungswarteschlangen festlegen, um sicherzustellen, dass die Nachrichten im Warteschlangenmanager des Brokers eintreffen.

    In diesem Szenario müssen die Konfigurationsdateien aus dem Broker-Server kopiert werden.

  • Szenario 4: Dieses Szenario ist mit Szenario 2 identisch, nutzt jedoch zur Verteilung der Arbeit für mehrere Broker eine Netzlastausgleichsfunktion:

    Die Konfiguration kann mit derjenigen aus Szenario 2 identisch sein, wobei die IP-Adresse der Netzlastausgleichsfunktion die Stelle des Brokerservers einnimmt. Im Allgemeinen können keine Konfigurationsdateien verwendet werden, da hinter einer virtuellen IP-Adresse mehrere Broker stehen, von denen jeder eine andere Konfigurationsdatei hat. Das Servlet lädt die Informationen jeweils mit einer eigenen Verbindung und nutzt für jeden Broker die richtigen Konfigurationsdaten.

    Da diese Konfiguration häufig aufgrund der Vorteile eines Ausweichbetriebs (Failover) verwendet wird, können sich auch die folgenden Zusatzoptionen als nützlich erweisen:

    Durch die Festlegung von clientModeConnectRetryCount kann sichergestellt werden, dass ein einzelner fehlgeschlagener Server keine Unterbrechungsfehler verursacht, und zwar selbst dann, wenn die Lastausgleichsfunktion eine einfache Rundverbindungszuteilung vornimmt. Wird der Parameter auf einen so hohen Wert gesetzt, dass versucht wird, zu allen Brokern eine Verbindung herzustellen, können in diesem Fall Probleme vermieden werden, und das Servlet wird den ersten verfügbaren Broker verwenden.

    Durch die Festlegung von reconnectActiveLinksAge kann die Wiederverwendung alter Verbindungen verhindert werden, die möglicherweise mittlerweile zwischen dem Servlet und der Lastausgleichsfunktion (bzw. zwischen der Lastausgleichsfunktion und den Brokern) von Firewalls gelöscht wurden. Wird dieser Parameter auf einen Wert gesetzt, der unter dem Firewall-Zeitlimit liegt, werden Verbindungen nur verwendet, wenn sie auch wirklich gültig sind.

    testConnectionBeforeReuse ist eine weitere Möglichkeit zur Handhabung gelöschter WebSphere MQ-Verknüpfungen zwischen dem Web-Servlet-Container und den Warteschlangenmanagern des Brokers. In diesem Fall wird vor der Einreihung von Daten in den Broker ein MQINQ-Aufruf ausgegeben. Wenn der MQINQ-Aufruf fehlschlägt, wird eine neue Verbindung hergestellt und die Daten werden über die neue Verbindung gesendet. Da bei dem MQPUT- und MQGET-Aufruf durch diese Konfiguration zusätzliche Schritte anfallen, erhöht sich der Systemaufwand bei allen Nachrichten beträchtlich. Daher sollte diese Option nur verwendet werden, wenn alle anderen Möglichkeiten ausgeschöpft sind.

Im Abschnitt Proxy-Servlets konfigurieren finden Sie Informationen zum Abschluss der Proxy-Servlet-Konfiguration:

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-02-27 15:19:31


ReferenzthemaReferenzthema | Version 8.0.0.2 | ac69430_