# Criar configurações de cache do cluster

Antes de começar

Criar e configurar um cluster do Coherence. Consulte Criar clusters do Coherence e Configurar clusters do Coherence.

Um arquivo de configuração de cache do Coherence define os caches e os serviços que são usados por uma aplicação. Geralmente, um arquivo de configuração de cache está incluído em um módulo GAR. Um GAR é implantado em todos os servidores Coherence gerenciados na camada de dados e pode também ser implantado como parte de um EAR na camada da aplicação. O GAR garante que a configuração de cache esteja disponível em cada membro do cluster do Oracle Coherence. Entretanto, há casos de uso os quais exigem que um arquivo de configuração de cache diferente seja utilizado em determinados servidores Coherence gerenciados. Por exemplo, uma camada de proxy exige acesso a todos os artefatos do GAR, mas precisa de um arquivo de configuração de cache diferente que defina os serviços de proxy a serem iniciados.

Você pode usar a Console de Administração para definir uma configuração de cache do cluster. Um arquivo de configuração de cache pode ser associado aos clusters do WebLogic ou aos Servidores Coherence Gerenciados no runtime. Nesse caso, a configuração de cache substitui o arquivo de configuração de cache incluído em um GAR. É possível também omitir o arquivo de configuração de cache de um arquivo GAR e designá-lo no runtime. Para substituir um arquivo de configuração de cache no runtime, esse arquivo deve estar vinculado a um nome de JNDI. O nome da JNDI é definido usando o atributo `override-property` do elemento `<cache-configuration-ref>`. O elemento encontra-se no arquivo `coherence-application.xml` que está compactado em um arquivo GAR. Para obter detalhes sobre o arquivo `coherence-application.xml`, consulte Oracle Fusion Middleware Developing Oracle Coherence Applications for Oracle WebLogic Server. Para obter mais informações sobre como importar um arquivo de configuração de cache, consulte Usando um Arquivo de Configuração de Cache do Cluster.

Para definir uma configuração de cache do cluster:

1. Se você ainda não tiver feito isso, no Centro de Alterações da Console de Administração, clique em Bloquear e Editar (consulte Usar o Centro de Alterações).
2. No painel esquerdo da Console, expanda Ambiente e selecione Clusters Coherence.
3. Selecione o cluster para o qual você deseja criar uma configuração de cache do cluster.
4. Selecione a página Configuração: Configurações de Cache e clique em Novo.
5. Na página Criar uma Configuração de Cache, defina as seguintes propriedades de configuração de cache:
   1. Nome: informe o nome desta configuração de cache do cluster.
   2. Nome da JNDI: digite o nome da JNDI à qual o arquivo de configuração de cache está vinculado. Esse nome da JNDI é prefixado com `cache-config/` e deve corresponder ao valor da `propriedade de substituição` da entrada `cache-configuration-ref` no arquivo `coherence-application.xml`. Por exemplo, o nome da JNDI `ExamplesGAR` deve corresponder à propriedade de substituição `cache-config/ExamplesGAR`.
   3. Arquivo de Configuração de Cache: digite o caminho completo para o arquivo de configuração de cache. Se preferir, você pode especificar um URL.
   4. Importar Arquivo de Configuração: selecione esta opção para importar o arquivo de configuração de cache da localização especificada na estrutura de diretórios do WebLogic Server.

      Se você não selecionar esta opção, o arquivo de configuração de cache será carregado diretamente da localização especificada quando o servidor for iniciado.

6. Clique em Salvar.
7. Selecione a página Destinos para escolher as instâncias ou os clusters do WebLogic Server aos quais se destina essa configuração de cache do cluster. Clique em Salvar.
8. Para ativar essas alterações, no Centro de Alterações da Console de Administração, clique em Ativar Alterações.
   Nem todas as alterações entram em vigor imediatamente; algumas algumas delas precisam ser reinicializadas (consulte Usar o Centro de Alterações).

Resultado

A configuração de cache do cluster é listada na página Configuração: Configurações de Cache da página da console de definições do cluster do Coherence.