WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Parameter des brokerweiten HTTP-Empfangsprogramms

Wählen Sie die Ressourcen und Eigenschaften im Zusammenhang mit dem zu ändernden brokerweiten HTTP-Empfangsprogramm aus.

Zum Ändern dieser Eigenschaften müssen Sie den Brokernamen und den Parameter -b httplistener angeben.

Über die Komponente 'httplistener' werden die Brokereigenschaften definiert, die für alle HTTP- und SOAP-Empfangs- und -Antwortknoten verwendet werden, welche für die Verwendung des brokerweiten Empfangsprogramms konfiguriert sind.

Sie müssen den Broker erneut starten, damit alle Änderungen implementiert werden.

Die folgenden Kombinationen sind für die Komponente 'httplistener' gültig:

-o HTTPListener

Die folgenden Eigenschaften und Werte sind gültig:
-n enableSSLConnector
Setzen Sie diesen Wert auf true, wenn das HTTP-Empfangsprogramm für eingehende SSL-Verbindungen empfangsbereit sein soll.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false
-n startListener
Setzen Sie den Wert auf true, wenn alle HTTP-Knoten in allen Ausführungsgruppen das brokerweite Empfangsprogramm verwenden sollen (sofern Sie nicht über den Befehl mqsichangeproperties für eine Ausführungsgruppe das integrierte Empfangsprogramm der betreffenden Ausführungsgruppe aktiviert haben). Im Abschnitt Parameter des HTTP-Empfangsprogramms für Ausführungsgruppen (SOAP- und HTTP-Knoten) finden Sie Informationen zur entsprechenden Konfiguration einer Ausführungsgruppe, wenn das eingebettete Empfangsprogramm von den HTTP-Knoten verwendet werden soll.

Von SOAP-Knoten wird standardmäßig das integrierte Empfangsprogramm verwendet, sie können jedoch über den Befehl mqsichangeproperties auch für die Verwendung des brokerweiten Empfangsprogramms konfiguriert werden. Weitere Informationen hierzu finden Sie unter Von einem brokerweiten Empfangsprogramm auf integrierte Empfangsprogramme wechseln.

Setzen Sie diesen Wert auf false, wenn alle HTTP-Knoten das integrierte Empfangsprogramm der jeweiligen Ausführungsgruppe verwenden sollen.

  • Wertetyp - Boolescher Wert
  • Anfangswert - true

-o HTTPConnector

Die folgenden Eigenschaften und Werte sind gültig:
-n address
Legen Sie für Server mit mehreren IP-Adressen als Wert die IP-Adresse fest, unter welcher der Server an Port 7080 empfangsbereit ist. Ist diese Eigenschaft nicht definiert, wird Port 7080 für alle dem Server zugeordneten IP-Adressen verwendet. Es kann nur maximal eine Adresse angegeben werden.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
-n maxPostSize
Legen Sie als Wert die maximale POST-Größe (in Bytes) fest, die vom brokerweiten Empfangsprogramm verarbeitet werden kann. Legen Sie als Wert 0 fest, um die Begrenzung zu entfernen.
  • Wertetyp - Integer
  • Anfangswert - 2097152 (2 Megabytes)
-n acceptCount
Legen Sie als Wert die maximale Anzahl eingehender Verbindungsanforderungen fest, die in die Warteschlange eingereiht werden können. Nach Erreichen dieses Grenzwerts empfangene Anforderungen werden abgelehnt.
  • Wertetyp - Integer
  • Anfangswert - 100
-n compressableMimeTypes
Legen Sie als Wert eine Liste der MIME-Typen fest, die für die HTTP-Komprimierung in Frage kommen. Andere MIME-Typen werden nicht komprimiert.
  • Wertetyp - durch Kommas getrennte Liste
  • Anfangswert - text/html,text/xml,text/plain
-n compression
Legen Sie als Wert off fest, um die Komprimierung zu inaktivieren, on, wenn Textdaten komprimiert werden sollen, oder force, damit alle Daten komprimiert werden, bzw. geben Sie an wie viele Daten (in Bytes) mindestens empfangen werden müssen, damit die Ausgabe komprimiert wird. Ist die Komprimierung aktiviert und die Inhaltslänge nicht bekannt, wird die gesamte Ausgabe komprimiert.
  • Wertetyp - Zeichenfolge
  • Anfangswert - off
-n connectionLinger
Geben Sie als Wert an, wie viele Sekunden die (vom HTTP-Connector verwendeten) Sockets nach der Initialisierung eines Systemabschlusses aktiv bleiben müssen.
  • Wertetyp - Integer
  • Anfangswert - JVM -Standardwert
-n connectionTimeout
Geben Sie als Wert an, wie viele Millisekunden der HTTP-Connector auf den Empfang einer Anforderung warten muss, nachdem er eine Verbindung akzeptiert hat. Setzen Sie den Wert auf -1, wenn kein Zeitlimit gelten soll.
  • Wertetyp - Integer
  • Anfangswert - 60000
-n maxHttpHeaderSize
Geben Sie als Wert die maximale Größe (in Bytes) an, die das HTTP-Empfangsprogramm für einen HTTP-Header akzeptiert.
  • Wertetyp - Integer
  • Anfangswert - 8192 (8 Kilobytes)
-n maxKeepAliveRequests
Geben Sie als Wert an, wie viele Anforderungen maximal eine persistente Verbindung verwenden können. Legen Sie als Wert 1 fest, um Keepalive-Anforderungen zu inaktivieren und für jede Anforderung eine neue Verbindung zu erzwingen. Setzen Sie den Wert auf 0 oder -1, wenn die Anzahl der Anforderungen unbegrenzt sein soll.
  • Wertetyp - Integer
  • Anfangswert - 100
-n maxThreads
Geben Sie als Wert an, wie viele Threads maximal vom HTTP-Connector erstellt werden können.
  • Wertetyp - Integer
  • Anfangswert - 200
-n minSpareThreads
Geben Sie als Wert an, wie viele Threads mindestens aktiv sein müssen.
  • Wertetyp - Integer
  • Anfangswert - 10
-n noCompressionUserAgents
Legen Sie als Wert einen regulären Ausdruck fest, der die Komprimierung inaktiviert, wenn er mit dem Benutzeragenten-Header abgeglichen wird.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
-n restrictedUserAgents
Legen Sie als Wert einen regulären Ausdruck fest, der das Keepalive-Paket inaktiviert, wenn er mit dem Benutzeragenten-Header abgeglichen wird.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
-n socketBuffer
Legen Sie als Wert die Größe des Puffers (in Bytes) fest, die zum Puffern der Socketausgabe verwendet werden muss. Legen Sie als Wert -1 fest, wenn kein Puffer verwendet werden soll.
  • Wertetyp - Integer
  • Anfangswert - 9000 (9 Kilobytes)
-n tcpNoDelay
Setzen Sie den Wert auf true, wenn kleine Pakete sofort gesendet werden sollen.
  • Wertetyp - Boolescher Wert
  • Anfangswert - true
-n enableLookups
Setzen Sie den Wert auf true, wenn DNS-Suchen eingesetzt werden sollen, um den Hostnamen des fernen Clients zu melden. Setzen Sie den Wert auf false, wenn stattdessen die IP-Adresse zurückgegeben werden soll.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false

-o HTTPSConnector

Die für den Parameter HTTPConnector aufgelisteten Eigenschaften sind auch für HTTPSConnector gültig. Zusätzlich sind für den Parameter HTTPSConnector folgende Eigenschaften und Werte gültig:
-n algorithm
Legen Sie als Wert den zu verwendenden Algorithmus zur Zertifikatsverschlüsselung fest.
  • Wertetyp - Zeichenfolge
  • Anfangswert -
    • Solaris platformHP-UX platformSunX509 unter Solaris und HP-UX
    • AIX platformz/OS platformLinux platformWindows platformIbmX509 auf anderen Systemen (AIX, Linux, Windows, z/OS)
-n clientAuth
Setzen Sie den Wert auf true, wenn eine Verbindung erst akzeptiert werden kann, wenn von dem Client ein gültiges SSL-Zertifikat empfangen wurde.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false
-n keystoreFile
Legen Sie als Wert den Pfad und Dateinamen der Schlüsselspeicherdatei fest, in der das Serverzertifikat gespeichert ist.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Plattformstandard
-n keystorePass
Legen Sie als Wert das Kennwort für den Zugriff auf das Serverzertifikat in der Schlüsselspeicherdatei fest. Hierbei kann es sich um ein Kennwort in Klartext oder aber, falls der Wert mit dem Präfix "brokerKeystore::" versehen ist, um den über den Befehl mqsisetdbparms konfigurierten benannten Wert handeln.
  • Wertetyp - Zeichenfolge
  • Anfangswert - changeit
-n keystoreType
Legen Sie als Wert den Typ der verwendeten Schlüsselspeicherdatei fest.
  • Wertetyp - Zeichenfolge
  • Anfangswert - JKS
-n truststoreFile
Legen Sie als Wert den Pfad und Dateinamen der Truststore-Datei fest.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Plattformstandard
-n truststorePass
Legen Sie als Wert das Kennwort für den Zugriff auf die Truststore-Datei fest. Hierbei kann es sich um ein Kennwort in Klartext oder aber, falls der Wert mit dem Präfix "brokerTruststore::" versehen ist, um den über den Befehl mqsisetdbparms konfigurierten benannten Wert handeln.
  • Wertetyp - Zeichenfolge
  • Anfangswert - changeit
-n truststoreType
Legen Sie als Wert den Typ der verwendeten Truststore-Datei fest.
  • Wertetyp - Zeichenfolge
  • Anfangswert - JKS
-n sslProtocol
Legen Sie als Wert die Version des zu verwendenden SSL-Protokolls fest.
  • Wertetyp - Zeichenfolge
  • Anfangswert - TLS
-n ciphers
Legen Sie als Wert eine Liste der möglichen Verschlüsselungswerte fest. Ist kein Wert angegeben, kann jede Verschlüsselung verwendet werden. Der Client sendet eine Liste mit Chiffrierwerten in der Reihenfolge ihrer Priorität. Der Server wählt den ersten zulässigen Chiffrierwert in der Liste aus. Wenn keiner der Chiffrierwerte in der Liste geeignet ist, gibt der Server einen Handshakefehler zurück und schließt die Verbindung.
  • Wertetyp - durch Kommas getrennte Liste
  • Anfangswert - null
-n keyAlias
Legen Sie als Wert den Alias fest, der dem Serverzertifikat im Schlüsselspeicher gegeben wurde. Standardmäßig wird der erste Schlüssel im Schlüsselspeicher verwendet.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
-n keypass
Legen Sie als Wert das Kennwort für den Zugriff auf das Serverzertifikat in der Schlüsselspeicherdatei fest. Hierbei kann es sich um ein Kennwort in Klartext oder aber, falls der Wert mit dem Präfix "brokerKeystore::keypass" versehen ist, um den über den Befehl mqsisetdbparms konfigurierten benannten Wert handeln.
  • Wertetyp - Zeichenfolge
  • Anfangswert - changeit
-n sessionCacheSize
Legen Sie als Wert die maximale Anzahl an Sitzungen fest, die Sie für den SSL-Sitzungscache zulassen möchten. Diese zwischengespeicherten Sitzungen stehen für SSL-Sitzungsneuverhandlungen zur Verfügung.
  • Wertetyp - Integer
  • Anfangswert - 100
Tipp: Die gültigen Werte für keystoreType, sslProtocol und ciphers sind von der JSSE-Implementierung abhängig. Sie finden diese Werte in der Dokumentation, die vom JSSE-Provider zur Verfügung gestellt wurde. Eine Liste der Plattformen, die IBM® Java™ verwenden, finden Sie in Anhang A des IBM JSSE2 Guide unter http://www.ibm.com/developerworks/java/jdk/security/60/secguides/jsse2Docs/JSSE2RefGuide.html.

Beispiele zum Ändern von Parametern für die Komponente 'httplistener' finden Sie unter mqsichangeproperties-Befehl.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:44


ReferenzthemaReferenzthema | Version 8.0.0.5 | an09141_