Paramètres de l'instance de cache de servlet

Une instance de cache de servlet est un emplacement qui, en plus du cache dynamique partagé par défaut, permet à un cache dynamique de stocker, distribuer et partager des données. En utilisant des instances de cache de servlet, vous conférez aux applications une souplesse plus grande et une meilleure optimisation des ressources de la mémoire cache. Le nom JNDI (Java Naming and Directory Interface) spécifié pour l'instance de cache est mappé vers l'attribut de nom dans la balise <cache-instance> du fichier de configuration cachespec.xml.

Pour afficher cette page de la console d'administration, cliquez sur Ressources > Instances de cache > Instances de cache de servlet > nom_instance_cache.

Nom

Nom complet de la ressource (valeur obligatoire).

Nom JNDI

Indique le nom JNDI (Java Naming and Directory Interface) de la ressource. Spécifiez ce nom dans la zone d'attribut de nom dans la balise <cache-instance> du fichier de configuration cachespec.xml. Cette balise permet de rechercher l'instance de cache particulière dans laquelle les entrées de cache doivent être stockées.

Description

Description de la ressource. Cette zone est facultative.

Catégorie

Chaîne de catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. Cette zone est facultative.

Taille du cache

Indique un entier positif spécifiant le nombre maximal d'entrées que peut contenir le cache. La taille du cache s'exprime généralement en milliers.

Valeur par défaut 2000
Intervalle 100 - aucune valeur maximale définie
Priorité par défaut

Spécifie le niveau de priorité attribué par défaut aux servlets susceptibles d'être mis en cache. Cette valeur détermine le délai de conservation d'une entrée dans un cache plein.

La valeur recommandée est 1.

Activer le déchargement sur le disque

Indique si le déchargement sur le disque est activé.

Si le déchargement sur le disque est désactivé, une entrée est créée lorsque la mémoire cache est saturée, les propriétés sont configurées pour chaque entrée et l'algorithme utilisé le moins récemment est utilisé pour supprimer l'entrée de la mémoire cache. Si le déchargement sur le disque est activé, l'entrée qui serait supprimée de la mémoire cache est copiée sur le système de fichiers local. L'emplacement du fichier dépend de l'emplacement de déchargement sur le disque.

Valeur par défaut false
Emplacement du déchargement

Indique le répertoire utilisé pour le déchargement sur le disque.

Si l'emplacement de déchargement sur le disque n'est pas indiqué, la valeur par défaut, ${REPERTOIRE_TEMP_WAS}/noeud/nom_serveur/_dynacache/nom_JNDI_cache sera utilisée. Si l'emplacement de déchargement sur le disque est indiqué, le noeud, le nom de serveur et le nom de l'instance de cache sont ajoutés. Par exemple, ${RACINE_INSTALL_UTILISATEUR}/diskoffload génère l'emplacement sous la forme ${RACINE_INSTALL_UTILISATEUR}/diskoffload/noeud/nom_serveur/nom_JNDI_cache. Cette valeur est ignorée si l'option de déchargement sur le disque n'est pas activée.

La valeur par défaut de la propriété ${REPERTOIRE_TEMPORAIRE_WAS} est${RACINE_INSTALL_UTILISATEUR}/temp. Si vous modifiez la valeur de la propriété ${REPERTOIRE_TEMPORAIRE_WAS} après avoir démarré WebSphere Application Server mais que vous ne déplacez pas le contenu du cache sur disque dans le nouvel emplacement :
  • Le serveur d'applications crée un fichier cache-disque à l'emplacement du déchargement sur le disque.
  • Si le paramètre Vider sur le disque est activé, tout le contenu du cache sur disque stocké dans l'ancien emplacement est perdu lors du redémarrage du serveur d'applications.
Vider sur le disque

Indique si les objets placés dans la mémoire cache sont sauvegardés sur le disque lorsque le serveur est arrêté. Cette valeur est ignorée si l'option Activer le déchargement sur le disque n'est pas sélectionnée.

Valeur par défaut false
Taille limite du cache-disque en Mo

Indique la valeur maximale de la taille la mémoire cache du disque en Mo. Quand vous sélectionnez cette option, vous pouvez spécifier une valeur entière. Si vous n'indiquez aucune valeur, la taille est illimitée. Ce paramètre s'applique uniquement si l'activation du déchargement du disque est spécifiée pour la mémoire cache.

Valeur 0 à MAXINT. Une valeur égale à zéro indique une taille illimitée.
Taille limite du cache-disque en entrées

Indique la valeur maximale de la taille du disque-cache en nombre d'entrées. Quand vous sélectionnez cette option, vous pouvez spécifier une valeur entière. Si vous n'indiquez aucune valeur, la taille est illimitée. Ce paramètre s'applique uniquement si l'activation du déchargement du disque est spécifiée pour la mémoire cache.

Valeur 0 à MAXINT. Une valeur égale à zéro indique une taille illimitée.
Taille limite des entrées du cache-disque

Indique la valeur maximale de la taille d'une entrée individuelle de la mémoire cache en Mo Les entrées de la mémoire cache qui sont plus grandes, quand elles sont expulsées de la mémoire, ne sont pas déchargées sur le disque. Quand vous sélectionnez cette option, vous pouvez spécifier une valeur entière. Si vous n'indiquez aucune valeur, la taille est illimitée. Ce paramètre s'applique uniquement si l'activation du déchargement du disque est spécifiée pour la mémoire cache.

Valeur 0 à MAXINT. Une valeur égale à zéro indique une taille illimitée.
Paramètres des performances

Indique le niveau de performances requis par le cache-disque. Ce paramètre s'applique uniquement si enableDiskOffload est spécifié pour la mémoire cache. Les niveaux de performances déterminent comment les ressources de la mémoire doivent être utilisées sur les activités d'arrière-plan comme l'apurement de la mémoire cache, l'expiration, la récupération de place, etc. Ce paramètre s'applique uniquement si l'activation du déchargement du disque est spécifiée pour la mémoire cache.

Performances hautes et utilisation de la mémoire haute Indique que toutes les métadonnées seront conservées dans la mémoire.
Performances équilibrées et utilisation de la mémoire équilibrée Indique que des métadonnées seront conservées dans la mémoire. Ceci est le paramètre de performances par défaut qui fournira un équilibrage optimal des performances et de l'utilisation de la mémoire pour le plus grand nombre d'utilisateurs.
Performances basses et utilisation de la mémoire basse Indique qu'un nombre limité de métadonnées seront conservées dans la mémoire.
Personnalisé Indique que l'administrateur configurera explicitement les paramètres de la mémoire qui seront utilisés pour prendre en charge les activités d'arrière-plan ci-dessus. L'administrateur paramètre ces valeurs à l'aide de l'objet DiskCacheCustomPerformanceSettings.
Fréquence d'apurement du cache-disque

Indique une valeur pour la fréquence d'apurement du cache-disque, en minutes. Si cette valeur est égale à 0, l'apurement s'exécute uniquement à minuit. Ce paramètre s'applique uniquement quand le niveau des performances de déchargement du disque est bas, équilibré ou personnalisé. Le niveau de performances "haut" ne nécessite aucun apurement du disque et dans ce cas, cette valeur est ignorée.

Valeur 0 à 1440
Mémoire tampon maximale pour les identificateurs de mémoire cache par méta-entrée

Indique le nombre maximal d'identificateurs de mémoire cache stockés pour un modèle ou un identificateur de dépendance individuel dans les métadonnées du cache-disque dans la mémoire. Si cette limite est dépassée, les informations sont déchargées sur le disque. Ce paramètre s'applique uniquement quand le niveau des performances de déchargement du disque est PERSONNALISE.

Valeur de 100 à MAXINT
Mémoire tampon maximale pour les identificateurs de dépendance

Indique le nombre maximal de compartiments d'identificateurs de dépendance dans les métadonnées du cache-disque-dans la mémoire. Si cette limite est dépassée, les informations sont déchargées sur le disque. Ce paramètre s'applique uniquement quand le niveau des performances du cache-disque est "personnalisé".

Valeur de 100 à MAXINT
Mémoire tampon maximale pour les modèles

Indique le nombre maximal de compartiments de modèles qui se trouvent dans les métadonnées du cache-disque dans la mémoire. Si cette limite est dépassée, les informations sont déchargées sur le disque. Ce paramètre s'applique uniquement quand le niveau des performances du cache-disque est "personnalisé".

Valeur de 10 à MAXINT
Règles d'éviction

Indique l'algorithme d'expulsion que le cache-disque utilisera pour expulser les entrées une fois que le niveau haut est atteint. Ce paramètre s'applique uniquement si l'activation du déchargement du disque est spécifiée pour la mémoire cache.

Aucune Aucune règle d'expulsion, donc le cache-disque peut grandir jusqu'à ce qu'il atteigne sa limite et que le service de mémoire cache dynamique arrête d'écrire sur le disque
Aléatoire Quand la taille du disque atteint une limite de seuil haut, le récupérateur de place du cache-disque se réveille, prend au hasard des entrées sur le disque et les expulse jusqu'à ce que la taille atteigne une limite de seuil bas.
Taille Quand la taille du disque atteint une limite de seuil haut, le récupérateur de place du cache-disque se réveille, prend les entrées les plus grandes sur le disque et les expulse jusqu'à ce que la taille du disque atteigne une limite de seuil bas.
Seuil haut

Indique quand la règle d'expulsion démarre. Le seuil est exprimé en pourcentage de la taille du cache-disque, en Go ou en entrées. La fonction de récupération de place de la mémoire cache du disque se manifeste lorsque la taille du disque est supérieure à la limite de seuil haut. La valeur la plus faible limite la taille de la mémoire cache du disque en Go et en entrées. Ce paramètre s'applique uniquement quand la règle d'expulsion du cache-disque est paramétrée à aucune.

Valeurs 1 à 100
Seuil bas

Indique quand la règle d'expulsion est terminée. Le seuil est exprimé en pourcentage de la taille du cache-disque, en Go ou en entrées. La valeur la plus faible limite la taille de la mémoire cache du disque en Go et en entrées. La fonction de récupération de place de la mémoire cache du disque, lorsqu'elle est sollicitée, supprime des entrées jusqu'à ce que la taille du disque atteigne la plus faible limite. Ce paramètre s'applique uniquement quand la règle d'expulsion du cache-disque est paramétrée à aucune.

Valeurs 1 à 100
Activer la réplication du cache

La réplication du cache permet de partager les ID, les entrées et les invalidations en cache avec d'autres serveurs du domaine de réplication.

Cette option peut ne pas être disponible pour les instances de cache créées avec une version antérieure de WebSphere Application Server.

Domaine de réplication de groupes complet

Indique le domaine de réplication à partir duquel les données sont répliquées.

Indique le domaine de réplication à partir duquel les données sont répliquées. Choisissez l'un des domaines de réplication définis. Si aucun domaine de réplication n'apparaît dans la liste, vous devez en créer un lors de la création du cluster ou selon une méthode manuelle dans la console d'administration en cliquant sur Environnement > Domaines de réplication internes > Nouveau. Le domaine de réplication utilisé avec le service de cache dynamique doit utiliser une réplique de groupe intégrale. Ne partage pas les domaines de réplication entre les destinataires de la réplication. Le cache dynamique doit utiliser un domaine de réplication différent du gestionnaire de sessions ou des beans de session avec état (stateful).

Type de réplication

Indique les règles de partage globales pour cette instance de mémoire cache.

Les paramètres suivants sont disponibles :
  • Envoi et réception (Both push and pull) envoie l'ID de cache du contenu nouvellement mis à jour aux autres serveurs du domaine de réplication. Par la suite, si un autre serveur demande le contenu alors qu'il possède l'ID de l'entrée de cache du contenu mis à jour précédemment, il récupérera le contenu auprès du serveur de publication. Si une demande porte sur un ID qui n'a pas été publié, le serveur suppose que celui-ci n'existe pas dans le cluster et crée donc l'entrée correspondante.
  • Pull uniquement partage les entrées de la mémoire cache pour cette objet entre les serveurs d'applications, à la demande. Si un serveur d'applications reçoit un échec de cache pour cet objet, il interroge les serveurs d'applications associés pour vérifier s'ils possèdent l'objet. Si aucun serveur d'applications ne possède une copie mise en cache de l'objet, le serveur d'applications d'origine exécute la requête et génère l'objet. Ces entrées ne peuvent pas stocker de données non sérialisables. Ce mode de partage est déconseillé.
  • Push uniquement envoie l'ID et le contenu du nouveau cache à tous les autres serveurs du domaine de réplication.
  • La règle de partage Non partagé a pour effet d'empêcher le partage de l'ID cache et du contenu du cache avec d'autres serveurs du domaine de réplication.
Le paramètre par défaut d'un environnement sans cluster est Non partagé. Lors de l'activation de la réplication, la valeur par défaut est Non partagé.
Les paramètres suivants sont disponibles :
  • Envoi et réception (Both push and pull) envoie l'ID de cache du contenu nouvellement mis à jour aux autres serveurs du domaine de réplication. Par la suite, si un autre serveur demande le contenu alors qu'il possède l'ID de l'entrée de cache du contenu mis à jour précédemment, il récupérera le contenu auprès du serveur de publication. Si une demande porte sur un ID qui n'a pas été publié, le serveur suppose que celui-ci n'existe pas dans le cluster et crée donc l'entrée correspondante.
  • Pull uniquement partage les entrées de la mémoire cache pour cette objet entre les serveurs d'applications, à la demande. Si un serveur d'applications reçoit un échec de cache pour cet objet, il interroge les serveurs d'applications associés pour vérifier s'ils possèdent l'objet. Si aucun serveur d'applications ne possède une copie mise en cache de l'objet, le serveur d'applications d'origine exécute la requête et génère l'objet. Ces entrées ne peuvent pas stocker de données non sérialisables. Ce mode de partage est déconseillé.
  • Push uniquement envoie l'ID et le contenu du nouveau cache à tous les autres serveurs du domaine de réplication.
  • La règle de partage Non partagé a pour effet d'empêcher le partage de l'ID cache et du contenu du cache avec d'autres serveurs du domaine de réplication.
Lors de l'activation de la réplication, la valeur par défaut est Non partagé.
Fréquence d'extraction (Push)

Indique (en secondes) le délai d'attente avant l'envoi d'entrées de cache nouvelles ou modifiées aux autres serveurs.

Une valeur nulle (0) indique que l'envoi des entrées de cache est immédiat. L'association de cette propriété à une valeur supérieure à 0 (zéro) génère une procédure push "par lots" de toutes les entrées créées ou modifiées dans la mémoire cache durant la période. La valeur par défaut est 1.




Les liens marqués (en ligne) requièrent un accès à Internet.

Tâches associées
Référence associée
Collection d'instances de cache d'objet
Paramètres de l'instance de cache d'objet
Collection d'instances de cache de servlet


Nom du fichier : udyn_scacheinstancesettings.html