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 – 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><broker></TT> element and
remove the <TT><bean></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"><?xml version=<SPAN
class="code-quote">"1.0"</SPAN> encoding=<SPAN
class="code-quote">"UTF-8"</SPAN>?></SPAN>
+<SPAN class="code-tag"><beans xmlns=<SPAN
class="code-quote">"http://activemq.org/config/1.0"</SPAN>></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Allows us to use
system properties as variables in this configuration file --></SPAN></SPAN>
+ <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>>
+ <SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <journaledJDBC journalLogFiles=<SPAN
class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN
class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-data"</SPAN>/>
+ <SPAN class="code-tag"></persistenceAdapter></SPAN>
+
+ <SPAN class="code-tag"><transportConnectors></SPAN>
+ <SPAN class="code-tag"><transportConnector name=<SPAN
class="code-quote">"MyBrokerTCP"</SPAN> uri=<SPAN
class="code-quote">"tcp://0.0.0.0:61616"</SPAN> /></SPAN>
+ <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>
+<SPAN class="code-tag"></beans></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"><?xml version=<SPAN
class="code-quote">"1.0"</SPAN> encoding=<SPAN
class="code-quote">"UTF-8"</SPAN>?></SPAN>
+<SPAN class="code-tag"><beans xmlns=<SPAN
class="code-quote">"http://activemq.org/config/1.0"</SPAN>></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Allows us to use
system properties as variables in this configuration file --></SPAN></SPAN>
+ <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>>
+ <SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <journaledJDBC journalLogFiles=<SPAN
class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN
class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b1-data"</SPAN>/>
+ <SPAN class="code-tag"></persistenceAdapter></SPAN>
+
+ <SPAN class="code-tag"><transportConnectors></SPAN>
+ <SPAN class="code-tag"><transportConnector name=<SPAN
class="code-quote">"FirstBrokerTCP"</SPAN> uri=<SPAN
class="code-quote">"tcp://0.0.0.0:60010"</SPAN> /></SPAN>
+ <SPAN class="code-tag"></transportConnectors></SPAN>
+
+ <SPAN class="code-tag"><networkConnectors></SPAN>
+ <networkConnector name=<SPAN
class="code-quote">"Broker1ToBroker2"</SPAN>
+ uri=<SPAN
class="code-quote">"static://(tcp://localhost:60011)"</SPAN>
failover=<SPAN class="code-quote">"true"</SPAN>
+ userName=<SPAN
class="code-quote">"fixme"</SPAN> password=<SPAN
class="code-quote">"fixme"</SPAN>/>
+ <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>
+<SPAN class="code-tag"></beans></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"><?xml version=<SPAN
class="code-quote">"1.0"</SPAN> encoding=<SPAN
class="code-quote">"UTF-8"</SPAN>?></SPAN>
+<SPAN class="code-tag"><beans xmlns=<SPAN
class="code-quote">"http://activemq.org/config/1.0"</SPAN>></SPAN>
+ <SPAN class="code-tag"><SPAN class="code-comment"><!-- Allows us to use
system properties as variables in this configuration file --></SPAN></SPAN>
+ <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>>
+ <SPAN class="code-tag"><persistenceAdapter></SPAN>
+ <journaledJDBC journalLogFiles=<SPAN
class="code-quote">"5"</SPAN>
+ dataDirectory=<SPAN
class="code-quote">"/server/bea/weblogic920/domains/jms/activemq-b2-data"</SPAN>/>
+ <SPAN class="code-tag"></persistenceAdapter></SPAN>
+
+ <SPAN class="code-tag"><transportConnectors></SPAN>
+ <SPAN class="code-tag"><transportConnector name=<SPAN
class="code-quote">"SecondBrokerTCP"</SPAN> uri=<SPAN
class="code-quote">"tcp://0.0.0.0:60011"</SPAN> /></SPAN>
+ <SPAN class="code-tag"></transportConnectors></SPAN>
+
+ <SPAN class="code-tag"><networkConnectors></SPAN>
+ <networkConnector name=<SPAN
class="code-quote">"Broker2ToBroker1"</SPAN>
+ uri=<SPAN
class="code-quote">"static://(tcp://localhost:60010)"</SPAN>
failover=<SPAN class="code-quote">"true"</SPAN>
+ userName=<SPAN
class="code-quote">"fixme"</SPAN> password=<SPAN
class="code-quote">"fixme"</SPAN> />
+ <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>
+<SPAN class="code-tag"></beans></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">"INFO, out"</SPAN> or <SPAN
class="code-quote">"INFO, out, stdout"</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
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=13349&originalId=13364";>view
change</A>)
+ (<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>
