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 18:10:48 UTC

svn commit: r439365 - /incubator/activemq/site/weblogic-integration.html

Author: chirino
Date: Fri Sep  1 09:10:47 2006
New Revision: 439365

URL: http://svn.apache.org/viewvc?rev=439365&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=439365&r1=439364&r2=439365&view=diff
==============================================================================
--- incubator/activemq/site/weblogic-integration.html (original)
+++ incubator/activemq/site/weblogic-integration.html Fri Sep  1 09:10:47 2006
@@ -669,20 +669,145 @@
 
 <H5><A name="WebLogicIntegration-SampleActiveMQConfigurationFiles"></A>Sample ActiveMQ Configuration Files</H5>
 
-<P><B>TODO:</B> show and discuss:</P>
-<UL>
-	<LI>ActiveMQ config file for one broker or a network of brokers, with the plugins above</LI>
-</UL>
+<P>This section shows three sample ActiveMQ configuration files &ndash; one for a single broker with the security and management plugins listed above, and one for a network of two brokers with the security and management plugins listed above.  If you want to skip the security and management plugins, you can remove those attributes from the main <TT>&lt;broker&gt;</TT> element and remove the <TT>&lt;bean&gt;</TT> definitions for them below.</P>
+
+<P>It also shows a Log4J configuration file, which controls the ActiveMQ log output.</P>
 
+<P><B>Single Broker</B></P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><SPAN class="code-tag">&lt;?xml version=<SPAN class="code-quote">&quot;1.0&quot;</SPAN> encoding=<SPAN class="code-quote">&quot;UTF-8&quot;</SPAN>?&gt;</SPAN>
+<SPAN class="code-tag">&lt;beans xmlns=<SPAN class="code-quote">&quot;http://activemq.org/config/1.0&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- Allows us to use system properties as variables in this configuration file --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;bean class=<SPAN class="code-quote">&quot;org.springframework.beans.factory.config.PropertyPlaceholderConfigurer&quot;</SPAN>/&gt;</SPAN>
+  
+  &lt;broker useJmx=<SPAN class="code-quote">&quot;true&quot;</SPAN> brokerName=<SPAN class="code-quote">&quot;MyBroker&quot;</SPAN> useShutdownHook=<SPAN class="code-quote">&quot;false&quot;</SPAN>
+          managementContext=<SPAN class="code-quote">&quot;#WebLogicManagement&quot;</SPAN> plugins=<SPAN class="code-quote">&quot;#WebLogicSecurity&quot;</SPAN>&gt;
+    <SPAN class="code-tag">&lt;persistenceAdapter&gt;</SPAN>
+        &lt;journaledJDBC journalLogFiles=<SPAN class="code-quote">&quot;5&quot;</SPAN>
+                       dataDirectory=<SPAN class="code-quote">&quot;/server/bea/weblogic920/domains/jms/activemq-data&quot;</SPAN>/&gt;
+    <SPAN class="code-tag">&lt;/persistenceAdapter&gt;</SPAN>
+  
+    <SPAN class="code-tag">&lt;transportConnectors&gt;</SPAN>
+        <SPAN class="code-tag">&lt;transportConnector name=<SPAN class="code-quote">&quot;MyBrokerTCP&quot;</SPAN> uri=<SPAN class="code-quote">&quot;tcp://0.0.0.0:61616&quot;</SPAN> /&gt;</SPAN>
+    <SPAN class="code-tag">&lt;/transportConnectors&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/broker&gt;</SPAN>
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicManagement&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicManagement&quot;</SPAN> /&gt;
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicSecurity&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicSecurity&quot;</SPAN>&gt;
+      <SPAN class="code-tag">&lt;property name=<SPAN class="code-quote">&quot;authorizedGroup&quot;</SPAN> value=<SPAN class="code-quote">&quot;ActiveMQUsers&quot;</SPAN> /&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/bean&gt;</SPAN>
+<SPAN class="code-tag">&lt;/beans&gt;</SPAN></PRE>
+</DIV></DIV>
+
+<P><B>Network of Brokers (Broker 1/2)</B></P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><SPAN class="code-tag">&lt;?xml version=<SPAN class="code-quote">&quot;1.0&quot;</SPAN> encoding=<SPAN class="code-quote">&quot;UTF-8&quot;</SPAN>?&gt;</SPAN>
+<SPAN class="code-tag">&lt;beans xmlns=<SPAN class="code-quote">&quot;http://activemq.org/config/1.0&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- Allows us to use system properties as variables in this configuration file --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;bean class=<SPAN class="code-quote">&quot;org.springframework.beans.factory.config.PropertyPlaceholderConfigurer&quot;</SPAN>/&gt;</SPAN>
+  
+  &lt;broker useJmx=<SPAN class="code-quote">&quot;true&quot;</SPAN> brokerName=<SPAN class="code-quote">&quot;FirstBroker&quot;</SPAN> useShutdownHook=<SPAN class="code-quote">&quot;false&quot;</SPAN>
+          managementContext=<SPAN class="code-quote">&quot;#WebLogicManagement&quot;</SPAN> plugins=<SPAN class="code-quote">&quot;#WebLogicSecurity&quot;</SPAN>&gt;
+    <SPAN class="code-tag">&lt;persistenceAdapter&gt;</SPAN>
+        &lt;journaledJDBC journalLogFiles=<SPAN class="code-quote">&quot;5&quot;</SPAN>
+                       dataDirectory=<SPAN class="code-quote">&quot;/server/bea/weblogic920/domains/jms/activemq-b1-data&quot;</SPAN>/&gt;
+    <SPAN class="code-tag">&lt;/persistenceAdapter&gt;</SPAN>
+  
+    <SPAN class="code-tag">&lt;transportConnectors&gt;</SPAN>
+        <SPAN class="code-tag">&lt;transportConnector name=<SPAN class="code-quote">&quot;FirstBrokerTCP&quot;</SPAN> uri=<SPAN class="code-quote">&quot;tcp://0.0.0.0:60010&quot;</SPAN> /&gt;</SPAN>
+    <SPAN class="code-tag">&lt;/transportConnectors&gt;</SPAN>
+    
+    <SPAN class="code-tag">&lt;networkConnectors&gt;</SPAN>
+        &lt;networkConnector name=<SPAN class="code-quote">&quot;Broker1ToBroker2&quot;</SPAN>
+                          uri=<SPAN class="code-quote">&quot;static://(tcp://localhost:60011)&quot;</SPAN> failover=<SPAN class="code-quote">&quot;true&quot;</SPAN>
+                          userName=<SPAN class="code-quote">&quot;fixme&quot;</SPAN> password=<SPAN class="code-quote">&quot;fixme&quot;</SPAN>/&gt;
+    <SPAN class="code-tag">&lt;/networkConnectors&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/broker&gt;</SPAN>
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicManagement&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicManagement&quot;</SPAN> /&gt;
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicSecurity&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicSecurity&quot;</SPAN>&gt;
+      <SPAN class="code-tag">&lt;property name=<SPAN class="code-quote">&quot;authorizedGroup&quot;</SPAN> value=<SPAN class="code-quote">&quot;ActiveMQUsers&quot;</SPAN> /&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/bean&gt;</SPAN>
+<SPAN class="code-tag">&lt;/beans&gt;</SPAN></PRE>
+</DIV></DIV>
+
+<P><B>Network of Brokers (Broker 2/2)</B></P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><SPAN class="code-tag">&lt;?xml version=<SPAN class="code-quote">&quot;1.0&quot;</SPAN> encoding=<SPAN class="code-quote">&quot;UTF-8&quot;</SPAN>?&gt;</SPAN>
+<SPAN class="code-tag">&lt;beans xmlns=<SPAN class="code-quote">&quot;http://activemq.org/config/1.0&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- Allows us to use system properties as variables in this configuration file --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;bean class=<SPAN class="code-quote">&quot;org.springframework.beans.factory.config.PropertyPlaceholderConfigurer&quot;</SPAN>/&gt;</SPAN>
+  
+  &lt;broker useJmx=<SPAN class="code-quote">&quot;true&quot;</SPAN> brokerName=<SPAN class="code-quote">&quot;SecondBroker&quot;</SPAN> useShutdownHook=<SPAN class="code-quote">&quot;false&quot;</SPAN>
+          managementContext=<SPAN class="code-quote">&quot;#WebLogicManagement&quot;</SPAN> plugins=<SPAN class="code-quote">&quot;#WebLogicSecurity&quot;</SPAN>&gt;
+    <SPAN class="code-tag">&lt;persistenceAdapter&gt;</SPAN>
+        &lt;journaledJDBC journalLogFiles=<SPAN class="code-quote">&quot;5&quot;</SPAN>
+                       dataDirectory=<SPAN class="code-quote">&quot;/server/bea/weblogic920/domains/jms/activemq-b2-data&quot;</SPAN>/&gt;
+    <SPAN class="code-tag">&lt;/persistenceAdapter&gt;</SPAN>
+  
+    <SPAN class="code-tag">&lt;transportConnectors&gt;</SPAN>
+        <SPAN class="code-tag">&lt;transportConnector name=<SPAN class="code-quote">&quot;SecondBrokerTCP&quot;</SPAN> uri=<SPAN class="code-quote">&quot;tcp://0.0.0.0:60011&quot;</SPAN> /&gt;</SPAN>
+    <SPAN class="code-tag">&lt;/transportConnectors&gt;</SPAN>
+    
+    <SPAN class="code-tag">&lt;networkConnectors&gt;</SPAN>
+        &lt;networkConnector name=<SPAN class="code-quote">&quot;Broker2ToBroker1&quot;</SPAN>
+                          uri=<SPAN class="code-quote">&quot;static://(tcp://localhost:60010)&quot;</SPAN> failover=<SPAN class="code-quote">&quot;true&quot;</SPAN>
+                          userName=<SPAN class="code-quote">&quot;fixme&quot;</SPAN> password=<SPAN class="code-quote">&quot;fixme&quot;</SPAN> /&gt;
+    <SPAN class="code-tag">&lt;/networkConnectors&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/broker&gt;</SPAN>
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicManagement&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicManagement&quot;</SPAN> /&gt;
+
+  &lt;bean id=<SPAN class="code-quote">&quot;WebLogicSecurity&quot;</SPAN>
+        class=<SPAN class="code-quote">&quot;com.example.activemq.weblogic.ActiveMQToWebLogicSecurity&quot;</SPAN>&gt;
+      <SPAN class="code-tag">&lt;property name=<SPAN class="code-quote">&quot;authorizedGroup&quot;</SPAN> value=<SPAN class="code-quote">&quot;activemq&quot;</SPAN> /&gt;</SPAN>
+  <SPAN class="code-tag">&lt;/bean&gt;</SPAN>
+<SPAN class="code-tag">&lt;/beans&gt;</SPAN></PRE>
+</DIV></DIV>
+
+<P><B>Log4J Configuration File (<TT>log4j.properties</TT>)</B></P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java"># Can change <SPAN class="code-keyword">this</SPAN> to <SPAN class="code-quote">&quot;INFO, out&quot;</SPAN> or <SPAN class="code-quote">&quot;INFO, out, stdout&quot;</SPAN>
+# to enable logging to the file defined down below
+log4j.rootLogger=INFO, stdout
+log4j.logger.org.apache.activemq.spring=WARN
+log4j.logger.org.springframework=WARN
+log4j.logger.org.apache.xbean.spring=WARN
+
+# Configuration to log to stdout
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%-5p %-30.30c{1} - %m%n
+log4j.appender.stdout.threshold=INFO
+
+# Configuration <SPAN class="code-keyword">for</SPAN> a log file (in addition to or instead of stdout)
+log4j.appender.out=org.apache.log4j.RollingFileAppender
+log4j.appender.out.file=/server/bea/weblogic920/domains/test/activemq.log
+log4j.appender.out.maxFileSize=1024KB
+log4j.appender.out.maxBackupIndex=5
+log4j.appender.out.append=<SPAN class="code-keyword">true</SPAN>
+log4j.appender.out.layout=org.apache.log4j.PatternLayout
+log4j.appender.out.layout.ConversionPattern=%d [%-15.15t] %-5p %-30.30c{1} - %m%n</PRE>
+</DIV></DIV>
 
 <H4><A name="WebLogicIntegration-InstallationProcedure"></A>Installation Procedure</H4>
 
 <P>This procedure makes the following assumptions:</P>
 <UL>
 	<LI>The ActiveMQ configuration file and Log4J configuration file will be stored in a subdirectory of the WebLogic domain directory for ease of editing.  They may be packaged into <TT>WEB-INF/classes</TT> in the WAR for ease of distribution instead.</LI>
-	<LI>The ActiveMQ JMX management features will be exposed via the WebLogic runtime JMX MBeanServer..  This is not required, but it should allow existing WebLogic management scripts to see the ActiveMQ MBeans. <EM>NOTE: Additional configuration is required if the JRockit management server will be used instead, or if the embedded JMX server will be used instead and more than one ActiveMQ instance will be run on the same server.</EM></LI>
-	<LI>ActiveMQ will be installed on two WebLogic instances in a Network-of-Brokers configuration.</LI>
-	<LI>The two ActiveMQ instances will use specific URLs to locate each other, rather than attempting runtime discovery of arbitrary brokers that may be present on the network.</LI>
+	<LI>The ActiveMQ JMX management features will be exposed via the WebLogic runtime JMX MBeanServer.  This is not required, but it should allow existing WebLogic management scripts to see the ActiveMQ MBeans. <EM>NOTE: Additional configuration is required if the Sun JVM JMX server or JRockit management server will be used instead, or if the embedded ActiveMQ JMX server will be used instead and more than one ActiveMQ instance will be run on the same server.</EM></LI>
+	<LI>ActiveMQ will be installed on a single WebLogic instance or on two WebLogic instances in a Network-of-Brokers configuration.
+	<UL>
+		<LI>In a (Network-of-Brokers) cluster, the two ActiveMQ instances will use specific URLs to locate each other, rather than attempting runtime discovery of arbitrary brokers that may be present on the network.</LI>
+	</UL>
+	</LI>
 	<LI>Either ActiveMQ security is disabled, or ActiveMQ logins are validated against the WebLogic default security realm and a login is required and any member of a designated WebLogic group can access ActiveMQ.</LI>
 </UL>
 
@@ -750,7 +875,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
-                  &nbsp;(<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13349&originalId=13364">view change</A>)
+                  &nbsp;(<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13349&originalId=13365">view change</A>)
               
       (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13349">edit page</A>)
     </DIV>