Configurer ehcache

ehcache est un cache réparti Java™ code source ouvert pour la mise en cache, Java EE et les conteneurs pondérés. Chaque nœud du cluster peut utiliser le même fichier plan_ehcache.xml, mais vous pouvez aussi définir un fichier plan_ehcache.xml différent pour chaque nœud. Pour les installations dans un cluster, vous pouvez éditer le fichier plan_ehcache.xml de sorte qu'il n'est pas nécessaire de redémarrer l'ordinateur pour que les changements apportés aux modèles ou aux dossiers d'offres soient pris en compte.

Important : Si votre installation est mise à niveau à partir d'une version précédente, certaines ou toutes les sections du fichier plan_ehcache.xml peuvent manquer. Dans ce cas, ajoutez le fichier et éditez-le comme indiqué dans les sections qui suivent.
Remarque : Vous devez fournir un nom unique s'il n'est pas déjà présent, comme <ehcache updateCheck="false" name="PlanEhCacheManager">.

Utilisez l'une des procédures suivantes pour configurer le fichier ehcache.

Configuration d'ehcache avec invocation RMI

Les systèmes Unica Plan dont la topographie est la suivante utilisent généralement RMI :

Serveur avec équilibrage de charge, deux serveurs supplémentaires

Dans un éditeur de texte, ouvrez le fichier plan_ehcache.xml depuis le répertoire <HCL_Unica_Home>\<Plan_Home>\conf. Ensuite, apportez les modifications suivantes :

  • Annulez la mise en commentaire de la section suivante du fichier.

    Vous devez personnaliser les éléments affichés en gras (machineA, machineB et port) de manière à refléter votre environnement. Entrez la liste de toutes les machines du cluster, avec leur nom de système hôte qualifié complet, et séparées par une barre verticale.

    <!--
    <cacheManagerPeerProviderFactory 
    class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
    properties="peerDiscovery=manual,
    rmiUrls=//<ServerA>:40000/planApplicationCache|//<ServerB>:
    40000/planApplicationCache"/>
    
    <cacheManagerPeerListenerFactory
    class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory" 
    properties="port=40000, socketTimeoutMillis=20000"/>
    -->
  • Annulez la mise en commentaire de la section suivante du fichier.
    <!--
    <cacheEventListenerFactory
    class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
    properties="replicateAsynchronously=true, replicatePuts=true,
    replicateUpdates=true, replicateUpdatesViaCopy=true,
    replicateRemovals=true"/>
    <cacheEventListenerFactory
    class="com.unicacorp.uap.common.cache.PlanCacheEventListenerFactory
    "net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory" />
    -->
  • Si les lignes suivantes sont présentes dans le fichier, retirez-les.
    <bootstrapCacheLoaderFactory class=net.sf.ehcache.distribution.
    RMIBootstrapCacheLoaderFactory"/>

Configuration d'ehcache avec multidiffusion

Les systèmes Unica Plan dont la topographie est la suivante utilisent généralement la multidiffusion :

Serveur avec équilibrage de charge, un serveur supplémentaire

Dans un éditeur de texte, ouvrez le fichier plan_ehcache.xml depuis le répertoire <HCL_Unica_Home>\<Plan_Home>\conf. Ensuite, apportez les modifications suivantes :

  • Annulez la mise en commentaire de la section suivante du fichier.

    Vous devez personnaliser les éléments affichés en gras (multicastGroupAddress et multicastGroupPort) de manière à refléter le groupe de multidiffusion et le port de votre environnement.

    <!--<cacheManagerPeerProviderFactory 
    class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory" 
    properties="peerDiscovery=automatic, multicastGroupAddress=230.0.0.1, 
    multicastGroupPort=4446, timeToLive=32"/>
    
    <cacheManagerPeerListenerFactory 
    class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"/>
    -->def
  • Annulez la mise en commentaire de la section suivante du fichier.
    <!--
    <cacheEventListenerFactory
    class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
    properties="replicateAsynchronously=true, replicatePuts=true,
    replicateUpdates=true, replicateUpdatesViaCopy=true,
    replicateRemovals=true"/>
    <cacheEventListenerFactory
    class="com.unicacorp.uap.common.cache.PlanCacheEventListenerFactory" />
    -->
  • Si les lignes suivantes sont présentes dans le fichier, retirez-les.
    <bootstrapCacheLoaderFactory
    class="net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"/>