Paramètres de mise en cache

Les paragraphes suivants décrivent les valeurs de mise en cache par défaut du fichier nom_instance.xml. Même si vous pouvez modifier  le fichier nom_instance.xml directement, il est recommandé d'utiliser le Gestionnaire de configuration pour configurer la mise en cache. 

<Cache
        AutoPageInvalidation="True"
        CacheDirsPerMember="100"
        CacheFilePath="nom de chemin d'accès absolu"
        Enabled="true"
        MaxObjectsPerMember="0"
        CacheDaemonPort="16999"
        CacheDaemonBindAddress="localhost"
        CacheConnectionTimeout="120 000"
        CacheDaemonMaxThreads="64"
        MaxAllowedRefreshPeriod="3600"
        CacheCleanupPollingInterval="600"
        CacheCleanupAgentHostname="hostname"
        CacheCleanupAgentPort="80"
        WebAppPath="/webapp/wcs/stores/servlet"
        CacheStoreClassName="com.ibm.commerce.cache.FileSystemCacheStore">  
    <CacheableURL name="TopCategoriesDisplay" sessionDependent="true">
            <KeySet name="Key Set #2" HashKey="catalogId" MemberKey="storeId" />
        <KeySet name="Key Set #3" HashKey="identifier" MemberKey="storeId" >
        <Key isMandatory="false" name="memberId" />
        </KeySet>
    </CacheableURL>
    <CacheableURL name="CategoryDisplay" sessionDependent="true">
        <KeySet name="Key Set #4" HashKey="categoryId" MemberKey="storeId" >
        <Key isMandatory="true" name="catalogId" />
        </KeySet>
    <KeySet name="Key Set #5" HashKey="identifier" MemberKey="storeId" >
    <Key isMandatory="false" name="memberId" />
    <Key isMandatory="true" name="catalogId" />
        </KeySet>
    <KeySet name="Key Set #6" HashKey="categoryId" MemberKey="storeId" >
    <Key isMandatory="true" name="catalogIdentifiers" />
    <Key isMandatory="false" name="catalogMemberId" />
        </KeySet>
    <KeySet name="Key Set #7" HashKey="identifier" MemberKey="storeId" >
    <Key isMandatory="true" name="catalogIdentifiers" />
    <Key isMandatory="false" name="catalogMemberId" />
    <Key isMandatory="false" name="memberId" />
        </KeySet>
</CacheableURL>
<CacheableURL name="ProductDisplay" sessionDependent="true">
    <KeySet name="Key Set #8" HashKey="productId" MemberKey="storeId" />
    <KeySet name="Key Set #9" HashKey="partNumber" MemberKey="storeId" >
<Key isMandatory="false" name="memberId" />
</KeySet>
</CacheableURL>
</Cache>

Cache
L'élément Cache contient des informations de configuration pour tous les paramètres de mémoire cache. Il comporte les attributs suivants :
AutoPageInvalidation
Active l'agent de nettoyage de la mémoire cache. Ce paramètre est obligatoire si vous devez utiliser l'invalidation de base lancée par un déclencheur ou l'instruction CacheDelete. La valeur par défaut est True.
CacheDirsPerMember
Définit le nombre de répertoires que la mémoire cache peut comporter pour chaque membre. Les valeurs correctes sont comprises entre 1 et 32768. La valeur par défaut est 100.
La division de la mémoire cache en répertoires aide à réduire les conflits d'E-S pour les mémoires cache de tailles moyenne à grande (supérieures à 1 000 fichiers). En général, vous devez essayer d'avoir moins de 1 000 fichiers par répertoire.
CacheFilePath
Définit le nom de chemin d'accès absolu du répertoire cache.
Indiquez plusieurs éléments CacheFilePath, séparés par des virgules, si la mémoire cache comprend plusieurs répertoires. Chaque membre ne figure que dans un seul répertoire. Des instances multiples sont autorisées. La valeur par défaut est :
Les informations suivantes s'appliquent à Windows (301 octets)unité:\WebSphere\CommerceServer\instances\nom_instance\cache

Les informations suivantes s'appliquent à Windows (301 octets)unité:\Program Files\WebSphere\CommerceServer\instances\nom_instance\cache
/usr/WebSphere/CommerceServer/instances/nom_instance/cache

/opt/WebSphere/CommerceServer/instances/nom_instance/cache
/QIBM/UserData/WebCommerce/instances/nom_instance/cache
Enabled
Indique si la mise en cache est activée.
False - Pas de mémoire cache.
True - La mise en mémoire cache est activée. Il s'agit de la valeur par défaut.
MaxObjectsPerMember
Définit le nombre maximal de fichiers qu'un membre est autorisé à stocker dans la mémoire cache. Lorsque cette valeur est atteinte, des pages sont automatiquement supprimées. Les dernières pages visualisées sont supprimées.
Une valeur inférieure à 0 indique qu'il n'existe pas de nombre maximum de fichiers par membre.
La valeur par défaut est 0.
CacheDaemonPort
Le port par défaut est 16999. Voir également l'instruction CacheDaemonBindAddress.
CacheDaemonBindAddress
La valeur par défaut est localhost. Ensemble, les instructions CacheDaemonPort et CacheDaemonBindAddress identifient l'adresse complète de liaison du port du démon cache.
CacheConnectionTimeout
Durée (en millisecondes) pendant laquelle le client de la mémoire cache attend avant de mettre fin à une demande de mise en mémoire cache. La valeur par défaut est 120 000 (2 minutes).
CacheDaemonMaxThreads
Le nombre maximum d'unités d'exécution démarrées dans le démon cache pour prendre en charge des pages de cache. La valeur par défaut est 64.
MaxAllowedRefreshPeriod
Durée (en secondes) après laquelle le démon de nettoyage de la mémoire cache désactive la mémoire cache s'il se trouve dans l'impossibilité de la nettoyer. Indiquez la valeur 0 pour une valeur infinie. La valeur de MaxAllowedRefreshPeriod doit être au minimum 4 fois plus grande que la valeur de CacheCleanupPollingInterval. La valeur par défaut est 3600.
CacheCleanupPollingInterval
Durée (en secondes) pendant laquelle le démon de nettoyage de la mémoire cache attend entre deux consultations successives de l'agent de nettoyage de mémoire cache pour détecter des demandes de nettoyage. Celles-ci comprennent des demandes déclenchées et des demandes lancées par l'instruction CacheDelete. La valeur par défaut est 600 secondes.
CacheCleanupAgentHostname
CacheCleanupAgentHostname et CacheCleanupAgentPort identifient l'adresse complète de l'agent de nettoyage de la mémoire cache. Cette adresse est utilisée pour envoyer des demandes HTTP du démon de nettoyage à l'agent de nettoyage de mémoire cache pour demander la liste des pages devant être supprimées de la mémoire cache. La valeur par défaut est le nom TCP/IP qualifié d'hôte de votre serveur WebSphere Commerce Server.
CacheCleanupAgentPort
La valeur par défaut est 80.
CacheStoreClassName
Réservé à un usage interne. Ne modifiez pas cette valeur.
WebAppPath
Chemin d'accès de WebSphere Application. Le chemin d'accès par défaut est /webapp/wcs/stores/servlet.
CacheableURL
Cet élément contient une configuration d'URL spécifique. Des instances multiples sont autorisées. L'élément CacheableURL contient les attributs suivants :
Name
Nom d'URL en cache. Par modèle, CategoryDisplay.
sessionDependent
Les valeurs admises sont :
KeySet
Un ensemble de clés est une liste de tous les paramètres obligatoires pour l'instruction. Certaines instructions acceptent plusieurs ensembles de clés. Par modèle, CategoryDisplay dispose de quatre ensembles de clés :

Des instances multiples sont autorisées. L'élément KeySet contient les attributs suivants :

name
Nom de l'instruction. Par modèle, CategoryDisplay
HashKey
Indique la clé qui contient la clé de hachage. Par modèle, la clé de hachage pour l'instruction CategoryDisplay est cgrfnbr.
Le système utilise la clé de hachage pour déterminer dans quel répertoire la page mise en cache doit être enregistrée.
MemberKey
Indique la clé qui contient le numéro de membre. Par exemple, pour l'instruction CategoryDisplay, la valeur de MemberKey est storeId.
Key
Cet élément contient des informations de configuration pour une clé unique, par exemple la clé prrfnbr. Les noms des clés ne peuvent pas être des clés déjà utilisées dans la clé de membre ou la clé de hachage. Des instances multiples sont autorisées. L'élément key comporte les attributs suivants :
isMandatory
Indique si la clé est obligatoire dans l'URL. Si une clé obligatoire n'est pas indiquée dans une URL, la page n'est pas mise en cache. Les valeurs admises sont les suivantes :
  • True - La mémoire cache n'est utilisée que lorsque ce paramètre est présent dans la demande d'URL.
  • False - La mémoire cache utilise la valeur lorsque ce paramètre est présent, mais essaye néanmoins d'utiliser la mémoire cache pour la demande même si le paramètre n'est pas présent dans l'URL.
Name
Nom de la clé telle qu'il figure dans l'URL, par exemple size.

Par exemple, si les pages ProductDisplay présentent des images de modèles qui ont la même couleur de cheveux que le client, vous pouvez ajouter le paramètre "haircolor" à l'URL. Auquel cas, vous spécifiez ensuite que les pages de la mémoire cache varient en fonction du paramètre de couleur des cheveux. Pour ce faire, ajoutez le paramètre ProductDisplay KeySet comme suit :

<CacheableURL name="ProductDisplay" sessionDependent="false">   
<KeySet name="Key Set #10" HashKey="productId" MemberKey="storeId">       
<Key name="haircolor" isMandatory="false"/>
    </KeySet>
<KeySet name="Key Set #11" HashKey="partNumber" MemberKey="storeId">
        <Key name="haircolor" isMandatory="false"/>
    </KeySet>
</CacheableURL>

Rubriques connexes (1275 octets)

Tâches connexes

Références connexes (1292 octets)

IBM copyright