[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management: Generierung der Datei "plugin-cfg.xml" steuern

Sie können die Standardattributwerte in der Datei plugin-cfg.xml überschreiben, die vom On Demand Router (ODR) automatisch generiert wird.

Die folgenden Elemente haben das Format com.ibm.ws.odr.plugincfg.<Element>.<Attributname>, wobei <Element> für den Namen des Schlüsselworts in der Konfigurationsdatei steht, das das Element, das ein Attribut enthält, bezeichnet, und <Attributname> für den Namen des Attributs, das sich in diesem Element befindet. Konfigurieren Sie die Elemente als JVM-Systemeigenschaften. Klicken Sie zum Setzen einer JVM-Systemeigenschaft im ODR in der Administrationskonsole auf Server > On Demand Router > Name_des_ODR > Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften > Neu.

Config

Dieses Element startet die Plug-in-Konfigurationsdatei. Es kann eines oder mehrere der folgenden Elemente und Attribute enthalten.

com.ibm.ws.odr.plugincfg.config.ASDisableNagle
Gibt an, ob der Benutzer den Nagle-Algorithmus für die Verbindung zwischen dem Plug-in und dem Server inaktivieren möchte.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.AcceptAllContent
Gibt an, ob Sie Inhalt in POST-, PUT-, GET- und HEAD-Anforderungen einschließen können, wenn ein Header vom Typ "Content-Length" oder "Transfer-encoding" im Anforderungsheader enthalten ist. Sie können einen der folgenden Werte für dieses Attribut angeben:
  • "True", wenn der Inhalt für alle Anforderungen erwartet und gelesen werden soll.
  • "False", wenn der Inhalt nur für POST- und PUT-Anforderungen erwartet und gelesen werden soll.

Der Standardwert ist false.

Der Standardwert ist true.

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
Gibt an, welche Portnummer verwendet wird, um URIs für eine sendRedirect-Anforderung zu erstellen.

Der Standardwert ist HostHeader.

com.ibm.ws.odr.plugincfg.config.ChunkedResponse
Gibt an, ob das Plug-in die Antwort an den Client gruppiert, wenn ein Header vom Typ "Transfer-Encoding : Chunked" in der Antwort enthalten ist.

Sie können einen der folgenden Werte für dieses Attribut angeben:

  • True, wenn das Plug-in die Antwort an den Client in Blöcke aufteilen (Chunk) soll, wenn ein Antwortheader vom Typ "Transfer-Encoding : Chunked" in der Antwort enthalten ist.
  • false, wenn die Antwort nicht in Blöcke aufgeteilt werden soll.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.IISDisableNagle
Gibt an, ob Sie den Nagle-Algorithmus inaktivieren möchten.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.IISPluginPriority
Gibt die Priorität an, mit der der Web-Server das Plug-in lädt. Sie können einen der folgenden Werte für dieses Attribut angeben:
  • High
  • Medium
  • Low

Der Standardwert ist High.

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
Gibt an, ob das Plug-in DNS-Fehler in einer Konfiguration beim Start ignoriert. Wenn dieses Argument den Wert true hat, ignoriert das Plug-in DNS-Fehler in einer Konfiguration und wird erfolgreich gestartet, wenn mindestens ein Server in jedem Server-Cluster den Hostnamen auflöst. Alle Server, für die der Hostname nicht aufgelöst werden kann, werden für die Lebensdauer der Konfiguration als nicht verfügbar gekennzeichnet. Der Hostname wird später beim Routing der Anforderungen nicht aufgelöst. Wenn ein DNS-Fehler auftritt, wird eine Protokollnachricht in die Plug-in-Protokolldatei geschrieben. Die Initialisierung des Plug-ins wird fortgesetzt, anstatt den Web-Server nicht zu starten.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.RefreshInterval
Das Zeitintervall (in Sekunden), in dem das Plug-in die Konfigurationsdatei auf Aktualisierungen oder Änderungen überprüfen soll. Das Plug-in überprüft die Datei auf alle Änderungen, die seit dem Laden der Plug-in-Konfiguration vorgenommen wurden.

Der Standardwert ist 60. In einer Entwicklungsumgebung, in der häufig Änderungen vorgenommen werden, sollten Sie das Zeitintervall auf einen kleineren Wert als 60 Sekunden setzen. In einer Produktionsumgebung sollten Sie einen höheren Wert als den Standardwert festlegen, weil nicht mehr so häufig Aktualisierungen an der Konfiguration vorgenommen werden. Wenn das erneute Laden des Plug-ins scheitert, enthält die Plug-in-Protokolldatei eine Nachricht, und es wird die vorherige Konfiguration weiterverwendet, bis die Plug-in-Konfigurationsdatei erfolgreich geladen wird. Sehen Sie sich die Plug-in-Protokolldatei an, um beim Auftreten eines Fehlers weitere Informationen zu erhalten.

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
Die Plug-in-Datei liest den Antwortteil in 64-KB-Blöcken, bis alle Antwortdaten gelesen sind. Dies stellt ein Leistungsproblem für Anforderungen dar, deren Antwortteil ein großes Datenvolumen enthält.

Verwenden Sie dieses Attribut, um die maximale Blockgröße für das Lesen des Antwortteils festzulegen. Beispiel: Config ResponseChunkSize="N">, wobei "N" der Blockgröße in Kilobytes entspricht.

Wenn die Inhaltslänge des Antwortteils unbekannt ist, wird eine Puffergröße von N Kilobytes zugeordnet, und der Antwortteil wird in N KB-Blöcken gelesen, bis der gesamte Hauptteil gelesen ist. Wenn die Inhaltslänge bekannt ist, wird für das Lesen des Antwortteils eine Puffergröße verwendet, die entweder der Inhaltslänge oder N entspricht.

Die Standardblockgröße sind 64 KB.

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
Gibt an, dass die Portnummer für den Abgleich des virtuellen Hosts verwendet wird. Die folgenden Werte können angegeben werden:
  • true für einen physischen Abgleich unter Verwendung der Portnummer, an der die Anforderung empfangen wird.
  • false für einen logischen Abgleich unter Verwendung der Portnummer, die im Host-Header enthalten ist.

Der Standardwert ist False.

com.ibm.ws.odr.plugincfg.odrIncludeStopped
Gibt an, dass der Einschluss gestoppter ODR zugelassen werden soll. Die folgenden Werte können angegeben werden:
  • true: Gestoppte ODR werden eingeschlossen.
  • false: Gestoppte ODR werden nicht eingeschlossen.

Der Standardwert ist False.

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable
Gibt die anerkannten Proxys an. Die folgenden Werte können angegeben werden:
  • true: Anerkannte Proxys werden eingeschlossen.
  • false: Anerkannte Proxys werden nicht eingeschlossen.

Der Standardwert ist False. Die anerkannten Proxys werden über die definierten anerkannten Sicherheitsproxys auf der Seite Eigenschaften für On Demand Router > Einstellungen für On Demand Router der Administrationskonsole erfasst.

Log

Dieses Element beschreibt die Position und den Detaillierungsgrad der Protokollnachrichten, die vom Plug-in geschrieben werden. Wenn in der Konfigurationsdatei kein Element "log" angegeben wird, können die Protokollnachrichten in das Fehlerprotokoll geschrieben werden.

com.ibm.ws.odr.plugincfg.log.Name
Der vollständig qualifizierte Pfad zur Protokolldatei, in die das Plug-in Fehlernachrichten schreibt.

Der Standardwert ist Profilstammverzeichnis/logs/http_plugin.log.

com.ibm.ws.odr.plugincfg.log.LogLevel
Der Detaillierungsgrad der Protokollnachrichten, die das Plug-in in das Protokoll schreibt. Sie können einen der folgenden Werte für dieses Attribut angeben:
  • Trace. Es werden alle Schritte im Anforderungsprozess detailliert protokolliert.
  • Stats. Der für die jeweilige Anforderung ausgewählte Server und weitere Lastausgleichsinformationen, die sich auf die Anforderungsverarbeitung beziehen, werden protokolliert.
  • Warn. Es werden alle Warnungen und Fehlernachrichten, die sich aus einer abnormalen Anforderungsverarbeitung ergeben, protokolliert.
  • Error. Es werden nur Fehlernachrichten, die sich aus einer abnormalen Anforderungsverarbeitung ergeben, protokolliert.
  • Debug. Alle in Verarbeitungsanforderungen ausgeführten kritischen Schritte werden protokolliert.
  • Detail. Alle Informationen zu Anforderungen und Antworten werden protokolliert.
Der Standardwert ist Error.
Vorsicht:
Auf der Tracestufe werden sehr viele Nachrichten protokolliert, was dazu führen kann, dass sich das Dateisystem sehr schnell füllt. Verwenden Sie die Traceeinstellung nicht in einer normal funktionierenden Umgebung, das sich dies negativ auf die Leistung auswirkt.

ServerCluster

Dieses Element bezeichnet eine Gruppe von Servern, die im Allgemeinen so konfiguriert sind, dass sie denselben Typ von Anforderung verarbeiten.

Im einfachsten Fall enthält der Cluster eine einzige Serverdefinition. Wenn Sie mehrere Server definieren, führt das Plug-in einen Lastausgleich für alle definierten Server aus und verwendet dafür einen Umlauf- (Round Robin) oder Zufallsalgorithmus. Der Standardwert ist "Round Robin".

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
Einige Einheiten für Pervasive Computing können keinen Doppelpunkt (:), der zum Trennen der Klon-IDs bei der Sitzungsaffinität verwendet wird, verarbeiten. Dieses Attribut teilt dem Plug-in mit, ein Pluszeichen (+) als Trennzeichen für die Klon-IDs zu erwarten. Sie müssen die Serverkonfigurationen so ändern, dass der Server die Klon-IDs auch mit dem Pluszeichen trennen kann.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.cluster.LoadBalance
Die Round-Robin-Implementierung hat einen zufälligen Ausgangspunkt. Der erste Server wird zufällig ausgewählt, und der Round-Robin-Wert wird für die Auswahl weiterer Server verwendet. Diese Implementierung gewährleistet, dass bei der Verwendung mehrerer prozessbasierter Web-Server nicht alle Prozesse dadurch gestartet werden, dass die erste Anforderung an denselben Server gesendet wird.

Der Standardtyp für den Lastausgleich ist Round Robin.

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
Die für das Plug-in maximal zulässige Anzahl an Bytes des Anforderungsinhalts, die verwendet werden kann, um die Anforderung an einen Server zu senden. Wenn eine Anforderung empfangen wird, die diese Größe überschreitet, beendet das Plug-in die Anforderung.

Der Standardwert ist -1 (Bytes). Dieser Wert gibt an, dass die Größe von POST-Anforderungen nicht beschränkt ist.

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
Das Plug-in fügt der Anforderung spezielle Header hinzu, bevor die Anforderung an den Server weitergeleitet wird. Diese Header enthalten Informationen zur Anforderung, die dann von der Anwendung verwendet werden. Standardmäßig entfernt das Plug-in diese Header aus eingehenden Anforderungen, bevor es die erforderlichen Header hinzufügt.

Der Standardwert ist true. Wenn Sie das Attribut auf "false" setzen, bedeutet dies ein potenzielles Sicherheitsrisiko, weil die Header in eingehenden Anforderungen nicht entfernt werden.

com.ibm.ws.odr.plugincfg.cluster.RetryInterval
Eine ganze Zahl, die die Zeit angibt, die ab dem Zeitpunkt, an dem ein Server als inaktiv gekennzeichnet wird, bis zu dem Zeitpunkt vergeht, an dem das Plug-in versucht, erneut eine Verbindung herzustellen.

Der Standardwert ist sind 60 Sekunden.

Server

Dieses Element bezeichnet eine Serverinstanz, die für die Verarbeitung der Anforderungen konfiguriert ist, die basierend auf den Routing-Regeln der Plug-in-Konfiguration an sie weitergeleitet werden. Das Element "server" entspricht einem Anwendungsserver, der auf der lokalen Workstation oder auf einer fernen Workstation ausgeführt wird.

com.ibm.ws.odr.plugincfg.server.ServerIOTimeout
Ermöglicht dem Plug-in, einen Zeitlimitwert (in Sekunden) für das Senden von Anforderungen an den und das Lesen von Antworten vom Server festzulegen
Beachten Sie bei der Auswahl eines Werts für dieses Attribut die folgenden Aspekte:
  • Ein Server benötigt für die Verarbeitung einer Anforderung unter Umständen mehrere Minuten. Wenn Sie einen zu niedrigen Wert für das Attribut "ServerIOTimeout" festlegen, ist es möglich, dass das Plug-in eine falsche Serverfehlerantwort an den Client sendet.
  • Wenn kein Wert festgelegt wird, verwendet das Plug-in die Standardvorgehensweise, bei der so lange Anforderungen auf den Server geschrieben und Antworten vom Server gelesen werden, bis die TCP-Verbindung das zulässige Zeitlimit überschreitet. Der Standardwert ist 900.
  • Anmerkung: Bei älteren Produktversionen ist der Standardwert 0. Wenn das Plug-in einen Standardwert von 0 verwendet, kann ein Fehler auftreten.

Weitere Informationen zur Konfiguration des Attributs "ServerIOTimeout" finden Sie im technischen Hinweis zur Konfiguration des Web-Server-Plug-ins.

com.ibm.ws.odr.plugincfg.server.ConnectTimeout
Ermöglicht dem Plug-in, nicht blockierende Verbindungen zum Anwendungsserver herzustellen, was von Vorteil ist, wenn das Plug-in keine Verbindung zur Zieladresse herstellen kann. Auf diese Weise kann das Plug-in feststellen, ob der Port verfügbar ist oder nicht.

Wenn kein Wert angegeben wird, stellt das Plug-in eine blockierende Verbindung her, in der das Plug-in wartet, bis eine Zeitlimitüberschreitung beim Betriebssystem auftritt, die dem Plug-in ermöglicht, den Server als nicht verfügbar zu kennzeichnen. Ein Wert größer als 0 gibt die Anzahl der Sekunden an, die das Plug-in auf eine erfolgreiche Verbindungsherstellung wartet. Wenn nach Ablauf dieses Zeitintervalls keine Verbindung hergestellt ist, kennzeichnet das Plug-in den Server als nicht verfügbar und fährt mit einem der anderen Server fort, die im Cluster definiert sind.

Der Standardwert ist 0.

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
Wird verwendet, wenn sich eine Proxy-Firewall zwischen dem Plug-in und dem Anwendungsserver befindet. In einem solchen Fall führt das Plug-in nicht wie erwartet einen Failover durch.

Das Plug-in kennzeichnet einen Server als gestoppt, wenn die Methode "connect()" beendet ist. Wenn sich jedoch eine Proxy-Firewall zwischen dem Plug-in und dem Anwendungsserver befindet, ist die Methode "connect()" auch dann erfolgreich, wenn der Back-End-Anwendungsserver gestoppt ist. Dies bewirkt, dass das Plug-in kein ordnungsgemäßes Failover auf die anderen Anwendungsserver durchführt.

Das Plug-in enthält dieses Attribut, um sicherzustellen, dass es gestartet ist, bevor die Anforderung gesendet wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.server.MaxConnections
Gibt die maximale Anzahl anstehender Verbindungen zum Server an, die zu jeder Zeit über einen Web-Server-Prozess übertragen werden können.

Der Standardwert ist -1.

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
Gibt an, ob die Unterstützung für "HTTP 1.1 100 Continue" verwendet werden soll, bevor der Anforderungsinhalt an den Anwendungsserver gesendet wird. Der Standardwert ist false. Das Plug-in wartet die Antwort "100 Continue" des Anwendungsservers nicht ab, bevor es den Anforderungsinhalt sendet.

Diese Eigenschaft wird für POST-Anforderungen ignoriert, um einen Fehler zu verhindern, der auftritt, wenn der Anwendungsserver eine Verbindung aufgrund einer Zeitlimitüberschreitung schließt.

Aktivieren Sie diese Funktion, wenn Sie das Plug-in für die Zusammenarbeit mit bestimmten Typen von Proxy-Firewalls konfigurieren.

Eigenschaft

com.ibm.ws.odr.plugincfg.property.ESIEnable
Wird verwendet, um den ESI-Prozessor (Edge Side Include) zu aktivieren oder zu inaktivieren. Wenn der ESI-Prozessor inaktiviert ist, werden die anderen ESI-Elemente in der Datei ignoriert.

Der Standardwert ist true.

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
Eine ganze Zahl, die die maximale Größe des Caches in 1-KB-Einheiten festlegt. Die maximale Standardgröße für den Cache sind 1024 Kilobytes (1 Megabyte). Wenn der Cache voll ist, ist der erste Eintrag, der aus dem Cache entfernt wird, der Eintrag, der seiner Verfallszeit am nächsten ist.
com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
Gibt an, ob der ESI-Prozessor Invalidierungen vom Anwendungsserver empfängt.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.property.https.keyring
Verwenden Sie dieses Element, um die Initialisierungsparameter anzugeben, wenn HTTPS als Transportprotokoll definiert ist.

Dieses Attribut ist ein unterstützter Name, der vom Transport erkannt wird. Der Standardwert für das Element "keyring" ist Profilstammverzeichnis/etc/plugin-key.kdb.

com.ibm.ws.odr.plugincfg.property.https.stashfile
Der Standardwert für die verdeckte Datei ist Profilstammverzeichnis/node/etc/plugin-key.sth.
com.ibm.ws.odr.plugincfg.property.PluginInstallRoot
Gibt den Installationspfad für das Plug-in an. Der Standardwert ist "". Setzen Sie den Wert jedoch auf den vollständig qualifizierten Pfad des Plug-in-Installationsstammverzeichnisses, oder die Eigenschaft wird nicht in der Datei plugin-cfg.xml angezeigt.

Hinweise für das Generieren der Datei "plugin-cfg.xml"

Wenn HAPluginCfgGeneration-Definitionen bedarfsgesteuert generiert werden sollen, gehen Sie wie folgt vor:
  1. Inaktivieren Sie die automatische Generierung. Setzen Sie die angepasste Zelleneigenschaft ODCPluginCfgDisabled_<genDefID> auf den Wert true.
  2. Wenn ein neues Plug-in generiert werden soll, führen Sie den folgenden Befehl aus:
    <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
    <IDs_der_Generierungsdefinition> <Knotenname> <Servername>
    Für diesen Befehl gilt Folgendes:
    IDs_der_Generierungsdefinition
    Dies ist eine Liste mit durch Kommas getrennten HAPluginCfgGeneration-IDs in der Form ODCPluginCfg_<genDef>.
    Knotenname
    Dies ist der Name des Knotens, der die Generierung ausführt.
    Servername
    Dies ist der Name des Prozesses, der die Generierung ausführt. Jeder für Intelligent Management erweiterte Prozess mit Ausnahme der XDAGENT-Prozesse kann die HAPluginCfgs-Konfiguration bedarfsgesteuert generieren. Beispiel:
    <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
    ODCPluginCfg_1,ODCPluginCfg_2 dmgrNodeName dmgr
Wenn Sie einschränken möchten, wie oft HAPluginCfgGeneration-Definitionen neu generiert werden sollen, setzen Sie die angepasste Zelleneigenschaft ODCPluginCfgMinGenerationDelay auf einen Wert, der die Zeit in Minuten zwischen den möglichen Generierungen angibt. Beispiel:
ODCPluginCfgMinGenerationDelay = 10
Die konfigurierten HAPluginCfgGeneration-Definitionen werden maximal alle 10 Minuten neu generiert. Wenn der Generator eine Benachrichtigung zum erneuten Erstellen der pluginCfgs erhält, verzögert er die Generierung der in den letzten 10 Minuten geschriebenen pluginCfgs.

Wenn Sie einschränken möchten, wie oft eine vom ODR generierte Datei plugin-cfg.xml neu generiert werden soll, setzen Sie die JVM-Eigenschaft com.ibm.ws.odr.plugincfg.minGenerationDelay auf einen Wert, der die Zeit in Minuten zwischen den möglichen Generierungen angibt. Anschließend stoppen Sie den ODR und starten ihn erneut.

Standardmäßig wird der konfigurierte statische Wert der Laufzeitwertigkeit verwendet, um gestoppte ODR-Prozesse in eine generierte Datei plugin-cfg.xml einzuschließen.

Wenn gestoppte ODR-Prozesse basierend auf dem aktuellen Wert der Laufzeitwertigkeit (immer 0) in eine generierte Datei plugin-cfg.xml eingeschlossen werden sollen, konfigurieren Sie die folgenden Einstellungen:
  • Für HAPluginCfgGenerator setzen Sie die angepasste Zelleneigenschaft ODCPluginCfgOdrIncludeStoppedStatic auf false.
  • Für ODR-generierte Dateien des Typs plugin-cfg.xml setzen Sie die JVM-Eigenschaft com.ibm.ws.odr.plugincfg.odrIncludeStoppedStatic auf false. Anschließend stoppen Sie den ODR und starten ihn erneut.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_odrpluginprops
Dateiname:rwve_odrpluginprops.html