Initialisierungsparameter für den Servlet-Kontext

Die folgende Liste mit Initialisierungsparametern für den Servlet-Kontext können in der Datei "splicer.properties" abhängig von der ausgewählten Verbindungsmethode (Splicing) angegeben werden.

Parameter

objectGridType

Die gültigen Werte für diesen Parameter sind die Zeichenfolgewerte REMOTE und EMBEDDED. Der Standardwert ist REMOTE.

Wenn Sie diesen Parameter auf REMOTE setzen, werden die Sitzungsdaten außerhalb des Servers gespeichert, in dem die Webanwendung ausgeführt wird.

Wenn dieser Parameter auf EMBEDDED gesetzt wird, wird ein integrierter eXtreme-Scale-Container in dem Anwendungsserverprozess gestartet, in dem die Webanwendung ausgeführt wird.

objectGridName

Ein Zeichenfolgewert, der den Namen der ObjectGrid-Instanz definiert, die für eine bestimmte Webanwendung verwendet wird. Der Standardname ist "session".

Diese Eigenschaft muss den objectGridName-Wert in der ObjectGrid-XML-Datei und in der XML-Implementierungsdatei widerspiegeln, die zum Starten der Container-Server von eXtreme Scale verwendet werden.

catalogHostPort

Der Katalogserver kann eine Verbindung zu einem Katalogserver aufgebaut werden, um eine clientseitige ObjectGrid-Instanz abzurufen. Der Wert muss im Format Host:Port<,Host:Port> angegeben werden. Der Host ist der Listener-Host, auf dem der Katalogserver ausgeführt wird. Der Port ist der Listener-Port für diesen Katalogserverprozess. Diese Liste kann beliebig lang sein und wird nur für Bootstrapping verwendet. Die erste geeignete Adresse wird verwendet. Sie ist in WebSphere Application Server optional, wenn die Eigenschaft catalog.services.cluster konfiguriert ist.

replicationInterval

Ein ganzzahliger Wert (in Sekunden), der das Intervall definiert, in dem aktualisierte Sitzungen in das ObjectGrid geschrieben werden. Der Standardwert sind 10 Sekunden. Die gültigen Werte sind 0 bis 60. 0 bedeutet, dass aktualisierte Sitzungen am Ende des Methodenaufrufs des Servlet-Service für jede Anforderung in das ObjectGrid geschrieben werden. Ein höherer replicationInterval-Wert verbessert die Leistung, weil weniger Aktualisierungen in das Datengrid geschrieben werden. Die Konfiguration ist bei einem höheren Wert jedoch weniger fehlertolerant.

Diese Einstellung gilt nur, wenn "objectGridType" auf REMOTE gesetzt ist.

sessionTableSize

Ein ganzzahliger Wert, der die Anzahl der Sitzungsreferenzen definiert, die im Speicher verwaltet werden. Der Standardwert ist 1000.

Diese Einstellung gilt nur für REMOTE-Topologien, weil die EMBEDDED-Topologie die Sitzungsdaten bereits auf derselben Schicht wie den Webcontainer enthält.

Sitzungen werden auf der Basis der LRU-Logik aus der speicherinternen Tabelle entfernt. Wenn eine Sitzung aus der speicherinternen Tabelle entfernt wird, wird sie im im Web-Container ungültig gemacht. Die Daten werden jedoch nicht aus dem Grid entfernt, sodass nachfolgende Anforderungen für diese Sitzungen die Daten weiterhin abrufen können. Dieser Wert muss höher sein als der Wert für die maximale Größe des Thread-Pools des Web-Containers, damit Konkurrenzsituationen im Sitzungscache verringert werden.

fragmentedSession

Die gültigen Werte für diesen Parameter sind die Zeichenfolgewerte true und false. Der Standardwert ist true. Mit dieser Einstellung können Sie steuern, ob das Produkt Sitzungsdaten als vollständigen Eintrag oder jedes Attribut einzeln speichert.

Setzen Sie den Parameter "fragmentedSession" auf true, wenn die Webanwendungssitzung viele Attribute oder große Attribute hat. Setzen Sie den Parameter "fragmentedSession" nur dann auf false, wenn eine Sitzung wenig Attribute hat, weil alle Attribute unter demselben Schlüssel im Datengrid gespeichert werden.

In der früheren filterbasierten Implementierung hat diese Eigenschaft den Namen "persistenceMechanism" mit den möglichen Werten "ObjectGridStore" (fragmentiert) und "ObjectGridAtomicSessionStore" (nicht fragmentiert).

securityEnabled

Die gültigen Werte für diesen Parameter sind die Zeichenfolgewerte true und false. Der Standardwert ist false. Diese Einstellung aktiviert die Sicherheit für eXtreme-Scale-Clients. Sie muss mit der Einstellung securityEnabled in der eXtreme-Scale-Servereigenschaftendatei übereinstimmen. Stimmen die Einstellungen nicht überein, tritt eine Ausnahme ein.

credentialGeneratorClass

Der Name der Klasse, die die Schnittstelle com.ibm.websphere.objectgrid.security.plugins.CredentialGenerator implementiert. Diese Klasse wird verwendet, um Berechtigungsnachweise für Clients abzurufen.

credentialGeneratorProps

Die Eigenschaften für die CredentialGenerator-Implementierungsklasse. Die Eigenschaften werden mit der Methode "setProperties(String)" auf das Objekt gesetzt. Der credentialGeneratorProps-Wert wird nur verwendet, wenn der Wert der Eigenschaft credentialGeneratorClass ungleich null ist.

objectGridXML

Die Position der Datei objectgrid.xml. Die integrierte XML-Datei in der eXtreme-Scale-Bibliothek wird automatisch geladen, wenn objectGridType=EMBEDDED und die Eigenschaft objectGridXML nicht angegeben sind.

objectGridDeploymentXML

Gibt die Position der XML-Datei für die ObjectGrid-Implementierungsrichtlinie an. Die integrierte XML-Datei in der eXtreme-Scale-Bibliothek wird automatisch geladen, wenn objectGridType=EMBEDDED und die Eigenschaft objectGridDeploymentXML nicht angegeben sind.

traceSpec

Gibt die IBM® WebSphere-Tracespezifikation als Zeichenfolgewert an. Verwenden Sie diese Einstellung für andere Anwendungsserver als WebSphere Application Server.

traceFile

Gibt die Position der Tracedatei als Zeichenfolgewert an. Verwenden Sie diese Einstellung für andere Anwendungsserver als WebSphere Application Server.

cookieDomain
Gibt an, ob Sitzungen auf mehreren Hosts zugänglich sein müssen. Setzen Sie den Wert auf den Namen der gemeinsamen Domäne der Hosts.
reuseSessionID
Setzen Sie diese Eigenschaft auf true, wenn der zugrunde liegende Web-Container Sitzungs-IDs für Anforderungen an verschiedene Hosts wiederverwendet. Der Standardwert ist false. Der Wert dieser Eigenschaft muss mit dem Wert im Web-Container übereinstimmen. Wenn Sie WebSphere Application Server verwenden und die HTTP-Sitzungspersistenz für eXtreme Scale über die Administrationskonsole oder Scripting mit dem Tool wsadmin konfigurieren, wird die angepasste Eigenschaft HttpSessionIdReuse=true des Web-Containers standardmäßig hinzugefügt. Die Eigenschaft reuseSessionID wird auch auf true gesetzt. Wenn Sie nicht möchten, dass die Sitzungs-IDs wiederverwendet werden, setzen Sie die angepasste Eigenschaft HttpSessionIdReuse=false im Webcontainer, bevor Sie die Sitzungspersistenz für eXtreme Scale konfigurieren.
shareSessionsAcrossWebApps
Gibt an, ob Sitzungen von mehreren Webanwendungen gemeinsam genutzt werden. Die gültigen Werte sind die Zeichenfolgewerte true und false. Die Standardeinstellung ist false. Gemäß der Servletspezifikation können HTTP-Sitzungen nicht von mehreren Webanwendungen gemeinsam genutzt werden. Damit diese gemeinsame Nutzung zugelassen wird, wird eine Erweiterung der Servletspezifikation bereitgestellt.
useURLEncoding
Setzen Sie diese Eigenschaft auf true, wenn Sie URL-Umschreibung aktivieren möchten. Der Standardwert ist false und gibt an, dass Cookies zum Speichern von Sitzungsdaten verwendet werden. Der Wert dieses Parameters muss mit den Einstellungen des Web-Containers für die Sitzungsverwaltung übereinstimmen.