Configure um ou mais brokers para
compartilhar dados no cache global usando um arquivo de políticas XML. Use um arquivo de políticas para aprimorar a disponibilidade do cache configurando um broker para hospedar dois servidores de catálogos. Use também um arquivo de políticas para hospedar servidores de contêiner em um broker de várias instâncias para alta disponibilidade.
Especifique um arquivo de políticas para uso dos brokers
configurando a política de cache com o nome e o caminho de arquivo do arquivo de políticas. Os arquivos de políticas são fornecidos no diretório de instalação
install_dir/sample/globalcache,
que contém as seguintes configurações:
Duas das políticas de amostra configuram um broker para hospedar dois servidores de catálogos. Essa configuração significa que se um dos servidores de catálogos for parado, o outro servidor de catálogos será usado e nenhum dado do cache será perdido. Entretanto, ter mais de um servidor de catálogos pode afetar o tempo de inicialização após o broker ser iniciado,
até que o cache esteja disponível.
Quando você configura a propriedade de nível do
broker como um arquivo de políticas, o arquivo de políticas é validado com relação a um esquema XML. Uma cópia do arquivo de esquema XML é fornecida em install_dir/cachesupport/schema.
Não edite os arquivos de política de amostra em seu local original; copie-os primeiro para o seu próprio sistema de arquivos. Os arquivos de políticas de amostra originais podem ser substituídos ao fazer manutenção no IBM Integration Bus.
Não
é possível usar o arquivo de políticas para corrigir funções de cache específicas para
servidores
de integração específicos. Em vez disso, você deve
utilizar a política nenhum; consulte Cache Global Integrado.
As etapas a seguir descrevem como configurar o cache global para vários brokers.
- Copie um dos arquivos de política de amostra do install_dir/sample/globalcache para
outro local em seu sistema de arquivos.
É possível colocar uma cópia do mesmo arquivo de políticas em cada
computador em que um broker esteja em execução, ou é possível fornecer uma única cópia do arquivo de políticas em um sistema de arquivos compartilhado para todos os brokers acessarem.
- Modifique o arquivo de políticas do seu sistema, especificando os
nomes dos brokers e os hosts do listener apropriados, o intervalo de portas
que o broker deve usar e quantos servidores de catálogos o broker hospeda. Como opção, você também pode especificar
um nome de domínio para todos os servidores de catálogos no cache integrado. Se você
não configurar um nome de domínio, o broker criará um.
Assegure-se de que a política atenda aos seguintes critérios:
- É possível definir 0, 1 ou 2 servidores de catálogos para um broker individual,
mas pelo menos um servidor de catálogos deve ser definido na política.
- Se dois brokers compartilharem um nome do host, você deverá configurar um intervalo de porta
distinto para cada broker.
- Assegure-se de que o intervalo de porta de cada broker inclua pelo menos 20
portas.
- Os nomes dos brokers e os hosts do listener especificados na política devem corresponder aos
valores definidos para os brokers.
- É possível definir apenas um nome de
domínio no arquivo de políticas.
- Se especificado, o nome de domínio
deve preceder os elementos do broker no arquivo de políticas.
- O arquivo de políticas deve ser codificado em UTF-8.
- O arquivo de políticas deve conter XML válido. O arquivo de políticas é validado com relação
a um esquema XML quando você configurar a propriedade no nível do broker. Também é possível validar
o arquivo de políticas com relação à cópia do esquema (policy.xsd)
que é fornecido em install_dir/cachesupport/schema.
- Se você estiver configurando um broker de várias instâncias, um elemento opcional listenerHost é fornecido como um filho do elemento broker para que você possa especificar mais de um host do listener. Nessa situação, o atributo listenerHost do broker elemento também é opcional. Entretanto, você deve especificar tanto o elemento listenerHost ou o atributo listenerHost.
- Se você estiver configurando um broker com diversas instâncias, você não pode especificar o elemento listenerHost mais de uma vez para um broker que está configurado para hospedar um ou mais servidores de catálogos.
Quando você usa um arquivo de políticas XML, a propriedade
portRange no nível do broker é ignorada. O intervalo de portas especificado no arquivo XML substitui a propriedade especificada para o broker.
- Salve o arquivo de políticas.
- Configure a política de cache como o nome completo do arquivo de políticas.
O caminho que você especifica deve ser absoluto, não relativo. Se usar uma unidade compartilhada no Windows, você deverá usar a sintaxe de caminho \\hostname\directory para a unidade compartilhada,
em vez de uma letra da unidade mapeada. O ID do usuário IBM Integration Bus que é usado para acessar o
caminho \\hostname\directory deve ter acesso de leitura
para o sistema de arquivos e deve usar a mesma senha.
É possível configurar a política de cache usando comandos (consulte Configurando o Cache Global Integrado Usando Comandos) ou IBM Integration Explorer (consulte Configurando o Cache Global Integrado Usando o IBM Integration Explorer).
- Reinicie cada broker.
Quando cada broker for reiniciado, ele usará os valores do arquivo de políticas
para determinar suas propriedades do cache. Cada broker contém até 4 servidores de contêiner. Para descobrir onde os servidores de contêiner são colocados, use o comando
mqsicacheadmin para executar o comando
showPlacement, conforme mostrado no seguinte exemplo:
mqsicacheadmin brokerName -c showPlacement
Também é possível usar o comando
mqsicacheadmin para mostrar componentes do cache em um cache com vários brokers. Por exemplo, o comando
listHosts mostra os nomes do host, o número de hosts e o número de catálogos no cache:
mqsicacheadmin brokerName -c listHosts