Paramètres d'initialisation du contexte de servlet

La liste qui suit de paramètres d'initialisation du contexte de servlet peut être spécifiée dans le fichier splicer.properties en fonction de la méthode de raccord choisie.

Paramètres

objectGridType

Valeur de type chaîne REMOTE ou EMBEDDED. La valeur par défaut est REMOTE.

Si la valeur est REMOTE, les données de session sont stockées en dehors du serveur sur lequel l'application Web est exécutée.

Si la valeur est EMBEDDED, un conteneur intégré eXtreme Scale démarre dans le processus serveur d'applications sur lequel l'application Web s'exécute.

objectGridName

Valeur de chaîne qui définit le nom de l'instance ObjectGrid utilisée pour une application Web particulière. Le nom par défaut est session.

Cette propriété doit refléter le nom objectGridName dans les fichiers XML ObjectGrid et XLM de déploiement utilisés pour démarrer les serveurs de conteneur eXtreme Scale.

catalogHostPort

Le serveur de catalogues peut être contacté pour obtenir une instance ObjectGrid côté client. La valeur doit avoir le format host:port<,host:port>. L'hôte est le programme d'écoute sur lequel le serveur de catalogue s'exécute. Le port est le port d'écoute du processus serveur de catalogue. La longueur de cette liste peut être arbitraire et la liste n'est utilisée que pour l'amorçage. La première adresse viable qui est utilisée. Elle est facultative dans WebSphere Application Server si la propriété catalog.services.cluster est défini.

replicationInterval

Entier (en secondes) qui définit le temps séparant deux écritures de sessions actualisées vers la grille. La valeur par défaut est 10 secondes. Les valeurs possibles sont comprises entre 0 et 60. 0 signifie que les sessions actualisées sont écrites dans la grille pour chaque demande dès la fin de l'appel à la méthode de service du servlet. Une valeur replicationInterval plus élevée améliore les performances, car un moins grand nombre de mises à jour sont écrites dans la grille de données. Mais, en même temps, une valeur supérieure à 0 rend la configuration moins tolérante aux pannes.

Ce paramètre s'applique uniquement lorsque objectGridType a la valeur REMOTE.

sessionTableSize

Entier qui définit le nombre de références de session conservées en mémoire. La valeur par défaut est 1000.

Ce paramètre appartient uniquement à une topologie REMOTE, car la topologie EMBEDDED a déjà les données de session dans le même groupe que le conteneur Web.

Les sessions sont expulsées de la table interne en fonction de la logique LRU (least recently used). Lorsqu'une session est expulsée de cette table, elle est invalidée dans le conteneur Web. Cependant, les données ne sont pas pour autant supprimées de la grille, ce qui permet aux demandes ultérieures de cette session de continuer à extraire les données. Cette valeur doit être supérieure à la valeur maximale du pool d'unités d'exécution du conteneur Web, ce qui réduit la contention sur le cache de session.

fragmentedSession

Valeur de type chaîne true ou false. La valeur par défaut est true. Ce paramètre permet de contrôler si le produit stocke les données de session en tant qu'entrée entière ou s'il stocke chaque attribut séparément.

Affectez au paramètre fragmentedSession la valeur true si la session d'application Web a de nombreux attributs ou des attributs avec des grandes tailles. Affectez à fragmentedSession la valeur false si une session a peu d'attributs, car tous les attributs sont stockés dans la même clé dans la grille de données.

Dans la précédente implémentation à base de filtres, il était fait référence à cette propriété en tant que mécanisme de persistance avec, comme valeurs possibles, ObjectGridStore (fragmentation) et ObjectGridAtomicSessionStore (non-fragmentation).

securityEnabled

Valeur de type chaîne true ou false. La valeur par défaut est false. Ce paramètre active la sécurité du client eXtreme Scale. Il doit correspondre au paramètre securityEnabled dans le fichier des propriétés sur serveur eXtreme Scale. Si les paramètres ne correspondent pas, une exception est générée.

credentialGeneratorClass

Le nom de la classe qui implémente l'interface com.ibm.websphere.objectgrid.security.plugins.CredentialGenerator. Cette classe sert à obtenir les données d'identification des clients.

credentialGeneratorProps

Les propriétés de la classe d'implémentation CredentialGenerator. Les propriétés correspondent à l'objet avec la méthode setProperties(String). La valeur credentialGeneratorProps n'est utilisée que si la valeur de la propriété credentialGeneratorClass n'est pas null.

objectGridXML

L'emplacement du fichier objectgrid.xml. Le fichier XML intégré regroupé dans la bibliothèque eXtreme Scale est chargé automatiquement si objectGridType=EMBEDDED et que la propriété objectGridXML n'est pas définie.

objectGridDeploymentXML

Indique l'emplacement du fichier XML de stratégie de déploiement d'objectGrid. Le fichier XML intégré regroupé dans la bibliothèque eXtreme Scale est chargé automatiquement si objectGridType=EMBEDDED et que la propriété objectGridDeploymentXML n'est pas définie.

traceSpec

Spécifie la spécification de trace d'IBM® WebSphere comme une valeur de chaîne. Utilisez ce paramètre pour des serveurs d'applications autres que WebSphere Application Server.

traceFile

Spécifie l'emplacement du fichier de trace sous forme de valeur de chaîne. Utilisez ce paramètre pour des serveurs d'applications autres que WebSphere Application Server.

cookieDomain
Spécifie si vous exigez que les sessions soient accessibles à travers les hôtes. Définissez la valeur avec le nom du domaine commun entre les hôtes.
reuseSessionID
A la valeur true si le conteneur Web sous-jacent réutilise les ID de session dans les demandes aux différents hôtes. La valeur par défaut est false. La valeur de cette propriété doit être la même que la valeur du conteneur Web. Si vous utilisez WebSphere Application Server et configurez la persistance de session HTTP eXtreme Scale en utilisant la console d'administration ou le scriptage de l'outil wsadmin, la propriété personnalisée du conteneur Web HttpSessionIdReuse=true est ajoutée par défaut. reuseSessionID a également la valeur true. Si vous ne voulez pas réutiliser l'ID de session, définissez la propriété HttpSessionIdReuse=false dans la propriété personnalisée du conteneur Web avant de configurer la persistance de session eXtreme Scale.
shareSessionsAcrossWebApps
Spécifie si les sessions sont partagées entre des applications Web ; spécifiée comme valeur de chaîne true ou false. La valeur par défaut est false. La spécification de servlet indique que les sessions HTTP ne peuvent pas être partagées entre des applications Web. Une extension à la spécification de servlet est fournie pour permettre ce partage.
useURLEncoding
Affectez-lui la valeur true pour activer la réécriture d'URL. La valeur par défaut est false, ce qui indique que les cookies sont utilisés pour stocker les données de session. La valeur de ce paramètre doit être identique à celle des paramètres de conteneur Web pour la gestion des sessions.