{"id":2950,"date":"2011-08-16T14:16:35","date_gmt":"2011-08-16T19:16:35","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=2950"},"modified":"2011-09-15T13:13:10","modified_gmt":"2011-09-15T18:13:10","slug":"setup-weblogic-10-3-1-aq-jms","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=2950","title":{"rendered":"WebLogic 11g: Setup AQ JMS"},"content":{"rendered":"

Overview<\/h2><\/span>\n

* Uses WebLogic JMS Foreign Server framework.
\n* Supports RAC via WebLogic Multi Data Sources.<\/p>\n

Configure Oracle AQ<\/h2><\/span>\n

* Follow this post<\/a> to create an AQ queue named TEST_QUEU<\/strong>E owned by a user name aq<\/strong>. <\/p>\n

Configure WebLogic Server<\/h2><\/span>\n

Configure a WebLogic Data Source<\/h3><\/span>\n

* Follow this post<\/a> to create a data source with following properties:
\n– Name: myAQDS<\/strong>
\n– JNDI Name: jdbc\/myAQDS<\/strong>
\n– Database Type: Oracle<\/strong>
\n– Database Driver: Oracle’s Driver (Thin XA) for Service connections; Verions:9.0.1 and later<\/strong><\/p>\n

Create a Dedicated JMS System Module<\/h3><\/span>\n

* Click soa_domain -> Services -> Messaging -> JMS Modules<\/strong>
\n* Click New<\/strong> button under JMS Modules.
\n* Enter
\n– Name: myAQJMSModule<\/strong>
\n– Descriptor File Name: myAQJMSModule-jms.xml<\/strong>
\n* Click Next<\/strong>.
\n* Select target server, e.g. soa_server1<\/strong>.
\n* Click Next<\/strong>.
\n* Click Finish<\/strong>.<\/p>\n

Create a JMS Foreign Server<\/h3><\/span>\n

* Click soa_domain -> Services -> Messaging -> JMS Modules<\/strong>
\n* Click the newly created mySQJMSModule<\/strong>.
\n* Click New <\/strong>button under Summary of Resources.
\n* On the Choose the type of resource you want to create screen, select Foreign Server<\/strong>.
\n* Name Foreign Server: myAQForeignServer<\/strong>
\n* Click Next<\/strong>.
\n* Click Finish<\/strong>.<\/p>\n

Configure JMS Foreign Server to Point to AQ Database via JNDI<\/h3><\/span>\n

* Click the newly created myAQForeignServer<\/strong>.
\n* Click Configuration -> General<\/strong> tab. Enter:
\n– JNDI Initial Context Factory: oracle.jms.AQjmsInitialContextFactory<\/strong>
\n– JNDI Properties: datasource=jdbc\/myAQDS<\/strong><\/p>\n

\"\"<\/h4><\/span>\n

* Click Save.<\/p>\n

Configure JMS Foreign Server Connection Factories<\/h3><\/span>\n

* Click soa_domain -> Services -> Messaging -> JMS Modules<\/strong>
\n* Click myAQJMSModule<\/strong>.
\n* Click myAQForeignServer<\/strong>.
\n* Click Configuration -> Connection Factories<\/strong> tab.
\n* Click New <\/strong>button. Enter:
\n– Name: myAQCF<\/strong>
\n– Local JNDI Name: jms\/aq\/myAQCF<\/strong>
\n– Remote JNDI Name: XAQueueConnectionFactory<\/strong><\/p>\n

\"\"<\/h4><\/span>\n

* Click OK<\/strong>.<\/p>\n

Other Remote JNDI Names for AQ JMS Connection Factories<\/h3><\/span>\n

* ConnectionFactory <\/strong>
\n– javax.jms.ConnectionFactory
\n* QueueConnectionFactory <\/strong>
\n– javax.jms.QueueConnectionFactory
\n* TopicConnectionFactory <\/strong>
\n– javax.jms.TopicConnectionFactory
\n* XAConnectionFactory <\/strong>
\n– javax.jms.XQConnectionFactory
\n* XAQueueConnectionFactory <\/strong>
\n– javax.jms.XAQueueConnectionFactory
\n* XATopicConnectionFactory <\/strong>
\n– javax.jms.XATopicConnectionFactory<\/p>\n

Configure AQ JMS Foreign Server Destinations<\/h3><\/span>\n

* Remote JNDI Names are mapped as follows:
\n– For queue: Queues\/queue_name<\/strong>
\n– For Topics: Topics\/topic_name<\/strong><\/p>\n

Configure Queue<\/h4><\/span>\n

* Click soa_domain -> Services -> Messaging -> JMS Modules<\/strong>
\n* Click myAQJMSModule<\/strong>.
\n* Click myAQForeignServer<\/strong>.
\n* Click Configuration -> Destinations<\/strong> tab.
\n* Click New <\/strong>button. Enter:
\n– Name: myAQTestQ<\/strong>
\n– Local JNDI Name: jms\/aq\/testQ<\/strong>
\n– Remote JNDI Name: Queues\/TEST_QUEUE<\/strong><\/p>\n

\"\"<\/h4><\/span>\n

* Click OK<\/strong>.<\/p>\n

Configure Topic<\/h4><\/span>\n

* Click soa_domain -> Services -> Messaging -> JMS Modules<\/strong>
\n* Click myAQJMSModule<\/strong>.
\n* Click myAQForeignServer<\/strong>.
\n* Click Configuration -> Destinations<\/strong> tab.
\n* Click New <\/strong>button. Enter:
\n– Name: myAQTestTopic<\/strong>
\n– Local JNDI Name: jms\/aq\/testTopic<\/strong>
\n– Remote JNDI Name: Topics\/TEST_TOPIC<\/strong>
\n* Click OK<\/strong>.<\/p>\n

Restart WebLogic Server Instance<\/h3><\/span>\n

* Don’t forget to restart <\/strong>WebLogic server instance.<\/p>\n

Error<\/h2><\/span>\n

java.lang.UnsupportedOperationException: Remote JDBC disabled<\/h3><\/span>\n

* Go to domain bin directory:
\ncd \/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain\/bin
\n* vi setDomainEnv.sh and set WLS_JDBC_REMOTE_ENABLED to true:<\/p>\n

\r\n#WLS_JDBC_REMOTE_ENABLED=\"-Dweblogic.jdbc.remoteEnabled=false\"\r\nWLS_JDBC_REMOTE_ENABLED=\"-Dweblogic.jdbc.remoteEnabled=true\"\r\nexport WLS_JDBC_REMOTE_ENABLED\r\n<\/pre>\n
* Restart <\/strong>server instance.<\/p>\n
java.io.NotSerializableException: oracle.jdbc.aq.AQDequeueOptions<\/h3><\/span>\n
Possible Cause<\/h4><\/span>\n
* You are using stand alone JMS client to access AQ JMS destinations. Since the foreign server was configured with JDBC JNDI <\/strong>lookup, JDBC connections thus obtained can not be serialized to standalone clients.<\/p>\n
Fix<\/h4><\/span>\n
* Configure foreign server to use direct JDBC connection (instead of JNDI lookup):<\/p>\n
\"\"<\/a><\/h4><\/span>\n
* Put following libraries in client classpath:
\n– AQ JMS, which contains following jars:
\n~ C:\\prog\\Oracle\\Middleware\\wlserver_10.3\\server\\lib\\api.jar,
\n~ C:\\prog\\Oracle\\Middleware\\modules\\javax.transaction_1.0.0.0_1-1.jar
\n– WebLogic 10.3 Remote-Client, which contains following jars:
\n~C:\\prog\\Oracle\\Middleware\\wlserver_10.3\\server\\lib\\weblogic.jar<\/p>\n
\"\"<\/a><\/h4><\/span>\n
* See here <\/a>for more info.
\n* See this post<\/a> for sample JMS client.<\/p>\n
References<\/h2><\/span>\n
* Interoperating with Oracle AQ JMS<\/a>
\n* Professional Oracle WebLogic Server By Robert Patrick, Gregory Nyberg, Philip Aston<\/a>
\n* Using AQ ( JMS Text message ) in WLS 10.3.1 <\/a>
\n* JMS in JDeveloper 11g and WebLogic 10.3<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Overview * Uses WebLogic JMS Foreign Server framework. * Supports RAC via WebLogic Multi Data Sources. Configure Oracle AQ * Follow this post to create an AQ queue named TEST_QUEUE owned by a user name aq. Configure WebLogic Server Configure … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[86,71,91],"tags":[],"class_list":["post-2950","post","type-post","status-publish","format-standard","hentry","category-aq","category-jms","category-weblogic"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-LA","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/2950","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2950"}],"version-history":[{"count":50,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/2950\/revisions"}],"predecessor-version":[{"id":3402,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/2950\/revisions\/3402"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2950"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2950"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2950"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}