You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by ch...@apache.org on 2006/09/01 20:11:14 UTC
svn commit: r439408 - /incubator/activemq/site/weblogic-integration.html
Author: chirino
Date: Fri Sep 1 11:11:13 2006
New Revision: 439408
URL: http://svn.apache.org/viewvc?rev=439408&view=rev
Log:
Latest export from confluence
Modified:
incubator/activemq/site/weblogic-integration.html
Modified: incubator/activemq/site/weblogic-integration.html
URL: http://svn.apache.org/viewvc/incubator/activemq/site/weblogic-integration.html?rev=439408&r1=439407&r2=439408&view=diff
==============================================================================
--- incubator/activemq/site/weblogic-integration.html (original)
+++ incubator/activemq/site/weblogic-integration.html Fri Sep 1 11:11:13 2006
@@ -365,7 +365,7 @@
<H4><A name="WebLogicIntegration-ActiveMQasaWebLogicApplication"></A>ActiveMQ as a WebLogic Application</H4>
-<P>The easiest type of WebLogic application to configure with all the needed ActiveMQ libraries and configuration and not much else is a web application. The JARs go in <TT>WEB-INF/lib/</TT> and config files typically in <TT>WEB-INF/</TT>. The only necessary configuration for the web application itself is to install a listener that will start and stop ActiveMQ when the web application is started and stopped. There are also a couple optional classes that can be used to integrate ActiveMQ with WebLogic's management and security systems. Additionally, in this example, a simple web page included in the WAR will be available whenever ActiveMQ is running, so a simple HTTP request can determine whether the ActiveMQ module has been started.</P>
+<P>The easiest type of WebLogic application to configure with all the needed ActiveMQ libraries and configuration and not much else is a web application. The JARs go in <TT>WEB-INF/lib/</TT> and config files typically in <TT>WEB-INF/</TT>. The only necessary configuration for the web application itself is to install a listener that will start and stop ActiveMQ when the web application is started and stopped. There are also a couple optional classes that can be used to integrate ActiveMQ with WebLogic's security system. Additionally, in this example, a simple web page included in the WAR will be available whenever ActiveMQ is running, so a simple HTTP request can determine whether the ActiveMQ module has been started.</P>
<H4><A name="WebLogicIntegration-ManagementOptions"></A>Management Options</H4>
@@ -384,7 +384,7 @@
</UL>
-<P>The sample below includes an optional class that lets ActiveMQ hook into the WebLogic runtime MBeanServer. This means ActiveMQ MBeans will appear alongside WebLogic MBeans (and even JVM MBeans if they are enabled). This means management clients will access ActiveMQ MBeans through the normal WebLogic listen port (e.g. 7001) rather than using a dedicated JMX port, though IIOP must be enabled for this to work. However, note that this is optional, and you can skip this class and use one of the other approaches (JVM or embedded MBeanServer) to expose the ActiveMQ MBeans.</P>
+<P>The sample below includes an optional configuration block that lets ActiveMQ hook into the WebLogic runtime MBeanServer. This means ActiveMQ MBeans will appear alongside WebLogic MBeans (and even JVM MBeans if they are enabled). With this approach, management clients will access ActiveMQ MBeans through the normal WebLogic listen port (e.g. 7001) rather than using a dedicated JMX port, though IIOP must be enabled for this to work. However, note that this is optional, and you can skip that configuration block and use one of the other approaches (JVM or embedded MBeanServer) to expose the ActiveMQ MBeans.</P>
<H4><A name="WebLogicIntegration-SecurityOptions"></A>Security Options</H4>
@@ -406,7 +406,7 @@
<LI>In order to start ActiveMQ when the web application is deployed, the <TT>web.xml</TT> includes a context listener for Spring, and the Spring <TT>applicationContext.xml</TT> file loads the ActiveMQ broker and points it to the ActiveMQ configuration file (which as mentioned above, is stored in a directory on the class path).</LI>
<LI>Within ActiveMQ:
<UL>
- <LI>A management plugin causes ActiveMQ to register all its JMX MBeans with the WebLogic JMX MBeanServer</LI>
+ <LI>A configuration block in the ActiveMQ configuration file causes ActiveMQ to register all its JMX MBeans with the WebLogic JMX MBeanServer</LI>
<LI>A security plugin causes all clients to authenticate against the WebLogic security realm</LI>
<LI>The security plugin also reads the name of a WebLogic group from the ActiveMQ configuration file, and requires that any client must be a member of that group (when WebLogic processed the login, it must have created a principal for that group for the user)</LI>
<LI>The ActiveMQ configuration file also identifies a network listen port that ActiveMQ will listen on for JMS clients. Any clients must include the server's hostname and this listen port in their connect URL.</LI>
@@ -473,41 +473,13 @@
<P>Additionally, to build the custom security plugins, the WebLogic <TT>server/lib/weblogic.jar</TT> is presently required at compile time.</P>
-<P>Of these, Derby could be omitted if ActiveMQ was configured to not use a database for persistence or to use a separate database for persistence. The WebLogic JAR is needed only at build time (it's provided by the server at runtime). Spring could be omitted if a different strategy was used to start and stop ActiveMQ when the web app was started or stopped (a little custom code could replace this dependency). The rest are probably unavoidable, unless ActiveMQ changes its dependencies in a future version.</P>
+<P>Of these, Derby could be omitted if ActiveMQ was configured to not use a database for persistence or to use a separate database (e.g. a WebLogic database pool) for persistence. The WebLogic JAR is needed only at build time (it's provided by the server at runtime). Spring could be omitted if a different strategy was used to start and stop ActiveMQ when the web app was started or stopped (a little custom code could replace this dependency). The rest are probably unavoidable, unless ActiveMQ changes its dependencies in a future version.</P>
<H5><A name="WebLogicIntegration-WebLogicIntegrationCode"></A>WebLogic Integration Code</H5>
-<P>There are several custom classes used for this example. We'll show in a minute how to configure ActiveMQ to use these. Note that these are all optional – if you don't want to leverage WebLogic's MBeanServer or security realm, you can skip these.</P>
+<P>There are two custom classes used for this example. We'll show in a minute how to configure ActiveMQ to use these. Note that these are optional – if you don't want to leverage WebLogic's security realm, you can skip these.</P>
-<P>The first lets ActiveMQ installed its JMX MBeans into the WebLogic runtime MBeanServer:</P>
-
-<P><B>ActiveMQToWebLogicManagement.java</B></P>
-
-<P>This class overrides the ActiveMQ default MBeanServer lookup behavior (in the ActiveMQ class <TT>ManagementContext</TT> to prefer the WebLogic runtime MBeanServer.</P>
-
-<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">/**
- * Makes ActiveMQ favor the WebLogic runtime MBeanServer
- */
-<SPAN class="code-keyword">public</SPAN> class ActiveMQToWebLogicManagement <SPAN class="code-keyword">extends</SPAN> ManagementContext {
- <SPAN class="code-keyword">protected</SPAN> <SPAN class="code-keyword">synchronized</SPAN> MBeanServer findMBeanServer() {
- <SPAN class="code-keyword">try</SPAN> {
- Context ctx = <SPAN class="code-keyword">new</SPAN> InitialContext();
- MBeanServer server = (MBeanServer) ctx.lookup(<SPAN class="code-quote">"java:comp/env/jmx/runtime"</SPAN>);
- <SPAN class="code-keyword">if</SPAN>(server != <SPAN class="code-keyword">null</SPAN>) {
- <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"ACTIVEMQ Found WebLogic MBeanServer"</SPAN>);
- <SPAN class="code-keyword">return</SPAN> server;
- }
- } <SPAN class="code-keyword">catch</SPAN> (NamingException e) {
- e.printStackTrace();
- }
- <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"ACTIVEMQ Did not find WebLogic MBeanServer"</SPAN>);
- <SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">super</SPAN>.findMBeanServer();
- }
-}</PRE>
-</DIV></DIV>
-
-<P>The next class makes ActiveMQ use the WebLogic security realm for authentication, and lets you specify a single WebLogic group to use for authorization (only members of that group can access ActiveMQ, though group members have full access to ActiveMQ).</P>
+<P>The first class makes ActiveMQ use the WebLogic security realm for authentication, and lets you specify a single WebLogic group to use for authorization (only members of that group can access ActiveMQ, though group members have full access to ActiveMQ).</P>
<P><B>ActiveMQToWebLogicSecurity.java</B></P>
@@ -553,7 +525,7 @@
}</PRE>
</DIV></DIV>
-<P>Finally, the last class is the authentication filter used by the class above to authenticate all logins against the WebLogic default security realm.</P>
+<P>The second class is the authentication filter used by the class above to authenticate all logins against the WebLogic default security realm.</P>
<P><B>ActiveMQWebLogicAuthenticationFilter.java</B></P>
@@ -681,10 +653,32 @@
<SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"</SPAN>/></SPAN>
<broker useJmx=<SPAN class="code-quote">"true"</SPAN> brokerName=<SPAN class="code-quote">"MyBroker"</SPAN> useShutdownHook=<SPAN class="code-quote">"false"</SPAN>
- managementContext=<SPAN class="code-quote">"#WebLogicManagement"</SPAN> plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+ plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Register all ActiveMQ MBeans with the WebLogic runtime MBeanServer --></SPAN></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><MBeanServer></SPAN>
+ <SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN> xmlns=""></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"java:comp/env/jmx/runtime"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"lookupOnStartup"</SPAN> value=<SPAN class="code-quote">"true"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"expectedType"</SPAN> value=<SPAN class="code-quote">"javax.management.MBeanServer"</SPAN> /></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+ <SPAN class="code-tag"></MBeanServer></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+
<SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- By default, use an embedded Derby database --></SPAN></SPAN>
<journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-data"</SPAN>/>
+ <!-- Use this with the WebLogicDataSource below to use a WebLogic
+ database connection pool instead of the embedded Derby database
+ <journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-data"</SPAN>
+ dataSource=<SPAN class="code-quote">"#WebLogicDataSource"</SPAN> />
+
+ -->
<SPAN class="code-tag"></persistenceAdapter></SPAN>
<SPAN class="code-tag"><transportConnectors></SPAN>
@@ -692,13 +686,18 @@
<SPAN class="code-tag"></transportConnectors></SPAN>
<SPAN class="code-tag"></broker></SPAN>
- <bean id=<SPAN class="code-quote">"WebLogicManagement"</SPAN>
- class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicManagement"</SPAN> />
-
<bean id=<SPAN class="code-quote">"WebLogicSecurity"</SPAN>
class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicSecurity"</SPAN>>
<SPAN class="code-tag"><property name=<SPAN class="code-quote">"authorizedGroup"</SPAN> value=<SPAN class="code-quote">"ActiveMQUsers"</SPAN> /></SPAN>
<SPAN class="code-tag"></bean></SPAN>
+
+<!-- Uncomment and configure this if you want to use a WebLogic database
+ connection pool for persistent messages
+ <bean id=<SPAN class="code-quote">"WebLogicDataSource"</SPAN>
+ class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN>>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"db/pool/jndi/name"</SPAN>/></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+-->
<SPAN class="code-tag"></beans></SPAN></PRE>
</DIV></DIV>
@@ -710,10 +709,32 @@
<SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"</SPAN>/></SPAN>
<broker useJmx=<SPAN class="code-quote">"true"</SPAN> brokerName=<SPAN class="code-quote">"FirstBroker"</SPAN> useShutdownHook=<SPAN class="code-quote">"false"</SPAN>
- managementContext=<SPAN class="code-quote">"#WebLogicManagement"</SPAN> plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+ plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Register all ActiveMQ MBeans with the WebLogic runtime MBeanServer --></SPAN></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><MBeanServer></SPAN>
+ <SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN> xmlns=""></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"java:comp/env/jmx/runtime"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"lookupOnStartup"</SPAN> value=<SPAN class="code-quote">"true"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"expectedType"</SPAN> value=<SPAN class="code-quote">"javax.management.MBeanServer"</SPAN> /></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+ <SPAN class="code-tag"></MBeanServer></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+
<SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- By default, use an embedded Derby database --></SPAN></SPAN>
<journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b1-data"</SPAN>/>
+ <!-- Use this with the WebLogicDataSource below to use a WebLogic
+ database connection pool instead of the embedded Derby database
+ <journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b1-data"</SPAN>
+ dataSource=<SPAN class="code-quote">"#WebLogicDataSource"</SPAN> />
+
+ -->
<SPAN class="code-tag"></persistenceAdapter></SPAN>
<SPAN class="code-tag"><transportConnectors></SPAN>
@@ -727,13 +748,18 @@
<SPAN class="code-tag"></networkConnectors></SPAN>
<SPAN class="code-tag"></broker></SPAN>
- <bean id=<SPAN class="code-quote">"WebLogicManagement"</SPAN>
- class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicManagement"</SPAN> />
-
<bean id=<SPAN class="code-quote">"WebLogicSecurity"</SPAN>
class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicSecurity"</SPAN>>
<SPAN class="code-tag"><property name=<SPAN class="code-quote">"authorizedGroup"</SPAN> value=<SPAN class="code-quote">"ActiveMQUsers"</SPAN> /></SPAN>
<SPAN class="code-tag"></bean></SPAN>
+
+<!-- Uncomment and configure this if you want to use a WebLogic database
+ connection pool for persistent messages
+ <bean id=<SPAN class="code-quote">"WebLogicDataSource"</SPAN>
+ class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN>>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"db/pool/jndi/name"</SPAN>/></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+-->
<SPAN class="code-tag"></beans></SPAN></PRE>
</DIV></DIV>
@@ -745,10 +771,32 @@
<SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"</SPAN>/></SPAN>
<broker useJmx=<SPAN class="code-quote">"true"</SPAN> brokerName=<SPAN class="code-quote">"SecondBroker"</SPAN> useShutdownHook=<SPAN class="code-quote">"false"</SPAN>
- managementContext=<SPAN class="code-quote">"#WebLogicManagement"</SPAN> plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+ plugins=<SPAN class="code-quote">"#WebLogicSecurity"</SPAN>>
+
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Register all ActiveMQ MBeans with the WebLogic runtime MBeanServer --></SPAN></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><managementContext></SPAN>
+ <SPAN class="code-tag"><MBeanServer></SPAN>
+ <SPAN class="code-tag"><bean class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN> xmlns=""></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"java:comp/env/jmx/runtime"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"lookupOnStartup"</SPAN> value=<SPAN class="code-quote">"true"</SPAN> /></SPAN>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"expectedType"</SPAN> value=<SPAN class="code-quote">"javax.management.MBeanServer"</SPAN> /></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+ <SPAN class="code-tag"></MBeanServer></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+ <SPAN class="code-tag"></managementContext></SPAN>
+
<SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- By default, use an embedded Derby database --></SPAN></SPAN>
<journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b2-data"</SPAN>/>
+ <!-- Use this with the WebLogicDataSource below to use a WebLogic
+ database connection pool instead of the embedded Derby database
+ <journaledJDBC journalLogFiles=<SPAN class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b2-data"</SPAN>
+ dataSource=<SPAN class="code-quote">"#WebLogicDataSource"</SPAN> />
+
+ -->
<SPAN class="code-tag"></persistenceAdapter></SPAN>
<SPAN class="code-tag"><transportConnectors></SPAN>
@@ -762,13 +810,18 @@
<SPAN class="code-tag"></networkConnectors></SPAN>
<SPAN class="code-tag"></broker></SPAN>
- <bean id=<SPAN class="code-quote">"WebLogicManagement"</SPAN>
- class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicManagement"</SPAN> />
-
<bean id=<SPAN class="code-quote">"WebLogicSecurity"</SPAN>
class=<SPAN class="code-quote">"com.example.activemq.weblogic.ActiveMQToWebLogicSecurity"</SPAN>>
<SPAN class="code-tag"><property name=<SPAN class="code-quote">"authorizedGroup"</SPAN> value=<SPAN class="code-quote">"activemq"</SPAN> /></SPAN>
<SPAN class="code-tag"></bean></SPAN>
+
+<!-- Uncomment and configure this if you want to use a WebLogic database
+ connection pool for persistent messages
+ <bean id=<SPAN class="code-quote">"WebLogicDataSource"</SPAN>
+ class=<SPAN class="code-quote">"org.springframework.jndi.JndiObjectFactoryBean"</SPAN>>
+ <SPAN class="code-tag"><property name=<SPAN class="code-quote">"jndiName"</SPAN> value=<SPAN class="code-quote">"db/pool/jndi/name"</SPAN>/></SPAN>
+ <SPAN class="code-tag"></bean></SPAN>
+-->
<SPAN class="code-tag"></beans></SPAN></PRE>
</DIV></DIV>
@@ -875,7 +928,7 @@
<DIV id="site-footer">
Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=ammulder">Aaron Mulder</A>,
last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=ammulder">Aaron Mulder</A> on Sep 01, 2006
- (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13349&originalId=13365">view change</A>)
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13349&originalId=13369">view change</A>)
(<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13349">edit page</A>)
</DIV>