15.3. Conteneurs de cache

Conteneurs de cache
Un conteneur de cache est le référentiel de caches utilisés par un sous-système. Dans Infinispan, les conteneurs de cache par défaut sont définis dans les fichiers de configuration xml (standalone-ha.xml, standalone-full-ha.xml, domain.xml). Un cache est défini comme le cache par défaut, et ce sera le cache qui sera utilisé pour le clustering.

Exemple 15.1. Définitions de conteneur cache du fichier de configuration standalone-ha.xml

<subsystem xmlns="urn:jboss:domain:infinispan:1.5">
       <cache-container name="singleton" aliases="cluster ha-partition" default-cache="default">
          <transport lock-timeout="60000"/>
          <replicated-cache name="default" mode="SYNC" batching="true">
             <locking isolation="REPEATABLE_READ"/>
          </replicated-cache>
       </cache-container>
       <cache-container name="web" aliases="standard-session-cache" default-cache="repl" module="org.jboss.as.clustering.web.infinispan">
        <transport lock-timeout="60000"/>
        <replicated-cache name="repl" mode="ASYNC" batching="true">
          <file-store/>
        </replicated-cache>
        <replicated-cache name="sso" mode="SYNC" batching="true"/>
          <distributed-cache name="dist" l1-lifespan="0" mode="ASYNC" batching="true">
           <file-store/>
          </distributed-cache>
        </cache-container>
Notez le cache par défaut défini dans chaque conteneur cache. Dans cet exemple, dans le conteneur cache web, le cache repl est défini par défaut. Le cache repl sera donc utilisé pour le clustering des sessions web.
Les conteneurs de cache et les attributs de cache peuvent être configurés par la console de gestion ou les commandes CLI, mais il n'est pas conseillé de modifier les noms des conteneurs cache, ni des caches eux-mêmes.
Configuration des conteneurs cache
Les conteneurs cache d'Infinispan peuvent être configurés par le CLI ou par la console de gestion.

Procédure 15.1. Configurer les conteneurs cache Infinispan dans la console de gestion

  1. Sélectionner l'onglet Configuration en haut de l'écran.
  2. En mode de domaine uniquement, sélectionner ha ou full-ha à partir du menu déroulant en haut et à gauche.
  3. Étendre le menu Subsystems, puis étendre le menu Infinispan. Sélectionner Cache Containers.
  4. Sélectionner un conteneur cache à partir du tableau Cache Containers.
  5. Ajouter, supprimer ou définir le conteneur de caches par défaut

    1. Pour créer un nouveau conteneur cache, cliquer sur Add dans le tableau Cache Containers.
    2. Pour supprimer le conteneur cache, sélectionner le conteneur cache dans le tableau Cache Containers. Cliquer sur Remove puis sur OK pour confirmer.
    3. Pour définir un conteneur cache comme défaut, cliquer sur Set Default, puis, saisir un nom de conteneur cache à partir de la liste de menu déroulant, puis sur Save pour confirmer.
  6. Pour ajouter ou mettre à jour les attributs d'un conteneur de cache, sélectionner le conteneur cache dans le tableau Cache Containers. Sélectionnez en un à partir des onglets Attributes, Transport ou Aliases qui se trouvent dans la partie d'écran Details, puis cliquer sur Edit. Pour avoir des informations supplémentaires sur le contenu des onglets Attributes, Transport et Aliases, cliquer sur Need Help?.

Procédure 15.2. Configurer les conteneurs cache Infinispan dans l'interface CLI

  1. Pour obtenir une liste des attributs configurables, saisir la commande CLI suivante :
    /profile=profile name/subsystem=infinispan/cache-container=container name:read-resource
  2. Vous pouvez utiliser l'interface CLI pour ajouter, supprimer, et mettre à jour les conteneurs cache. Avant d'utiliser des commandes avec les conteneurs cache, assurez-vous d'avoir le profil qui convient dans la commande CLI.
    1. Ajouter un conteneur cache

      Pour ajouter un conteneur cache, basez votre commande sur l'exemple suivant :
      /profile=profile-name/subsystem=infinispan/cache-container="cache container name":add
    2. Supprimer un conteneur cache

      Pour supprimer un conteneur cache, basez votre commande sur l'exemple suivant :
      /profile=profile-name/subsystem=infinispan/cache-container="cache container name":remove
    3. Mettez à jour les attributs de conteneur de cache

      Utiliser l'opération write-attribute pour écrire une nouvelle valeur dans un attribut. Vous pouvez utiliser l'onglet de complétion pour terminer la chaîne de commande en cours, ainsi que pour exposer les attributs disponibles. L'exemple suivant met à jour statistics-enable à true.
      /profile=profile name/subsystem=infinispan/cache-container=cache container name:write-attribute(name=statistics-enabled,value=true)