É possível configurar os nós JMS
para se comunicar com o Oracle AQ (Oracle 11g e acima). Essa comunicação
requer um servidor compatível com LDAP 3 para reter as definições de consulta do JNDI
pelos nós JMS.
- Conclua as etapas a seguir no Oracle AQ, consultando a
documentação do Oracle para os detalhes específicos de cada etapa.
- Você deve instalar o Servidor Oracle Internet Directory
(OID) para hospedar os objetos administrados por JNDI para Oracle AQ.
- É possível configurar o Oracle AQ para registrar connection factories e
destinos JMS (filas e tópicos) automaticamente com o servidor OID
quando esses connection factories e destinos JMS são criados no
banco de dados Oracle.
- Crie as tabelas de banco de dados para reter as filas e os tópicos
JMS.
- Crie as filas e os tópicos JMS e associe-os
às tabelas criadas na etapa 1b.
- Inclua definições para as conexões JMS no
servidor LDAP para permitir que os nós JMS do broker concluam a consulta JND
e se conectem ao servidor Oracle AQ.
- Registre os connection factories JMS com o servidor OID LDAP
usando as ferramentas administrativas fornecidas pelo Oracle.
- O diagrama a seguir descreve a forma da árvore de diretórios
para objetos administrados pelo JNDI para Oracle AQ.
- Copie os arquivos JAR do cliente JMS do Oracle AQ para um diretório local
acessível pelo broker.
- O arquivo aqapi.jar está localizado no servidor Oracle
AQ, no diretório oracle_install_path/rdbms/jlib.
- O arquivo ojdbc5.jar está localizado no servidor Oracle
AQ no diretório oracle_install_path/jdbc/lib.
- O orai18n.jar está localizado no servidor Oracle AQ no diretório oracle_install_path/jlib.
- Modifique o serviço configurável JMSProviders para Oracle
AQ; por exemplo:
mqsichangeproperties MyBroker –c JMSProviders –o Oracle_AQ
-n jarsURL,
InitialContextFactory,
jndiBindingsLocation
-v location of the Oracle Jars,
com.sun.jndi.ldap.LdapCtxFactory,
ldap://LDAP_server_address:LDAP_listener_port
- Configure as propriedades na guia Conexão JMS do
nó JMS (nó de entrada, de saída ou de resposta), conforme mostrado no exemplo a
seguir. Para obter informações adicionais sobre essas propriedades, consulteNó JMSInput.
- Configure a propriedade Nome do Provedor JMS
para Oracle_AQ.
- Configure a propriedade Factory de Contexto Inicial;
por exemplo:
com.sun.jndi.ldap.LdapCtxFactory
Para
todos os nós que fazem referência ao serviço configurável JMSProviders, se
essa propriedade for configurada no serviço configurável, ela substituirá a
propriedade configurada no nó.
- Configure a propriedade Ligações JNDI do Local;
por exemplo:
ldap://LDAP_server_address:LDAP_listener_port
Para
todos os nós que fazem referência ao serviço configurável JMSProviders, se
essa propriedade for configurada no serviço configurável, ela substituirá a
propriedade configurada no nó.
- Configure a propriedade Nome do Connection Factory.
Esse nome deve ser o caminho completo no diretório LDAP;
por exemplo:
cn=QCF,cn=oracledbconnections,cn=ORCL,cn=OracleContext,
ou=MyDept,o=MyCompany
Onde
- cn=QCF é o nome do connection factory JMS.
- cn=oracledbconnections é a ramificação para definições de connection factory
JMS.
- cn=ORCL é o nome do banco de dados Oracle AQ.
- cn=OracleContext é a raiz do esquema Oracle RDBMS.
- ou=MyDept, o=MyCompany é o contexto administrativo LDAP específico
da instalação.
- Na guia Básico, configure as propriedades dos destinos JMS (fila
ou tópico).
- Configure a propriedade Fila de Origem
no nó JMSInput. Essa
fila deve ser o caminho completo no diretório LDAP; por
exemplo:
cn=JMS.Queue,cn=oracleDBQueues,cn=ORCL,cn=OracleContext,
ou=MyDept,o=MyCompany
Onde
- cn=JMS.Queue é a fila JMS.
- cn=oracleDBQueues é a ramificação para filas e definições de tópicos JMS.
- cn=ORCL é o nome do banco de dados Oracle AQ.
- cn=OracleContext é a raiz do esquema Oracle RDBMS.
- ou=MyDept, o=MyCompany é o contexto administrativo LDAP específico
da instalação.
- Antes de o fluxo de mensagens ser iniciado, assegure-se de que a conexão JMS
tenha sido estabelecida usando o Event Viewer do
Windows.