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:
| 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. |
| 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. |
| 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. |
| 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. |
| 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:
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.
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.
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.
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: