# Créer des configurations de cache de cluster

Avant de commencer

Créez et configurez un cluster Coherence. Reportez-vous à Créer des clusters Coherence et à Configurer des clusters Coherence.

Un fichier de configuration de cache Coherence définit les caches et les services utilisés par une application. En règle générale, un fichier de configuration du cache est inclus dans un module GAR. Ce dernier est déployé vers tous les serveurs Coherence gérés du niveau de données ; il est également possible de le déployer dans le cadre d'un fichier EAR vers le niveau application. Le module GAR garantit que la configuration de cache est disponible sur chaque membre du cluster Oracle Coherence. Cependant, certains serveurs Coherence gérés nécessitent l'utilisation d'un autre fichier de configuration du cache. Par exemple, un niveau proxy doit avoir accès à tous les artefacts du module GAR, mais il a besoin d'un fichier de cache de configuration distinct qui définit les services proxy à démarrer.

La console d'administration permet de définir une configuration de cache de cluster. Vous pouvez associer un fichier de configuration de cache à des clusters WebLogic ou à des serveurs Coherence gérés lors de l'exécution. Dans ce cas, la configuration de cache prime sur le fichier de configuration de cache inclus dans un module GAR. Vous pouvez également omettre le fichier de configuration de cache dans le module GAR et l'affecter lors de l'exécution. Pour remplacer un fichier de configuration de cache au moment de l'exécution, celui-ci doit être lié à un nom JNDI. Ce nom JNDI est défini via l'attribut `override-property` de l'élément `<cache-configuration-ref>`. Cet élément se situe dans le fichier `coherence-application.xml`, lui-même packagé dans un module GAR. Pour plus d'informations sur le fichier `coherence-application.xml`, reportez-vous au manuel Oracle Fusion Middleware Developing Oracle Coherence Applications for Oracle WebLogic Server. Pour plus d'informations sur l'import d'un fichier de configuration de cache, reportez-vous à Utilisation d'un fichier de configuration de cache de cluster.

Pour définir une configuration de cache de cluster, procédez comme suit :

1. Si vous ne l'avez pas déjà fait, dans le centre des modifications de la console d'administration, cliquez sur Verrouiller et modifier (reportez-vous à Utiliser le centre des modifications).
2. Dans le panneau gauche de la console, développez Environnement et sélectionnez Clusters Coherence.
3. Sélectionnez le cluster pour lequel créer une configuration de cache de cluster.
4. Accédez à la page Configuration : Configurations de cache, puis cliquez sur Nouveau.
5. Sur la page Créer une configuration de cache, définissez les propriétés de configuration de cache suivantes :
   1. Nom : entrez le nom de cette configuration de cache de cluster.
   2. Nom JNDI : entrez le nom JNDI auquel le fichier de configuration de cache est lié. Ce nom JNDI a pour préfixe `cache-config/` et doit correspondre à la valeur `override-property` de l'entrée `cache-configuration-ref` figurant dans le fichier `coherence-application.xml`. Par exemple, le nom JNDI de `ExamplesGAR` doit correspondre à la valeur override-property de `cache-config/ExamplesGAR`.
   3. Fichier de configuration de cache : entrez le chemin complet du fichier de configuration de cache. Vous pouvez également indiquer une URL.
   4. Importer un fichier de configuration de cache : sélectionnez cette option pour importer le fichier de configuration de cache à partir de l'emplacement indiqué dans la structure de répertoires WebLogic Server.

      Si vous ne sélectionnez pas cette option, le fichier de configuration de cache est chargé directement à partir de l'emplacement indiqué au démarrage du serveur.

6. Cliquez sur Enregistrer.
7. Accédez à la page Cibles pour sélectionner les instances et les clusters WebLogic Server que cible cette configuration de cache de cluster. Cliquez sur Enregistrer.
8. Pour activer ces modifications, dans le centre des modifications de la console d'administration, cliquez sur Activer les modifications.
   Les modifications ne prennent pas toutes effet immédiatement ; certaines nécessitent un redémarrage (reportez-vous à Utiliser le centre des modifications).

Résultat

La configuration de cache de cluster est répertoriée sur la page Configuration : Configurations de cache dans la console des paramètres du cluster Coherence.