activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Kulp (Confluence)" <conflue...@apache.org>
Subject [CONF] Apache ActiveMQ > Running a 3.x Broker
Date Tue, 11 Feb 2014 15:34:00 GMT
<html>
    <head>
        <meta name="viewport" content="width=device-width" />
        <base href="https://cwiki.apache.org/confluence" />
        <style type="text/css">
    body, #email-content, #email-content-inner { font-family: Arial,FreeSans,Helvetica,sans-serif;
}
    body, p, blockquote, pre, code, td, th, li, dt, dd { font-size: 13px; }
    small { font-size: 11px; }

    body { width:100% !important; -webkit-font-smoothing: antialiased; }

    body,
    #email-wrapper { background-color: #f0f0f0; }
    #email-wrapper-inner { padding: 20px; text-align: center; }
    #email-content-inner { background-color: #fff; border: 1px solid #bbb; color: $menuTxtColour;
padding:20px; text-align:left; }
    #email-wrapper-inner > table { width: 100%; }
    #email-wrapper-inner.thin > table { margin: 0 auto; width: 50%; }
    #email-footer { padding: 0 16px 32px 16px; margin: 0; }

    .email-indent { margin: 8px 0 16px 0; }
    .email-comment { margin: 0 0 0 56px; }
    .email-comment.removed { background-color: #ffe7e7; border: 1px solid #df9898; padding:
0 8px;}

    #email-title-avatar { text-align: left; vertical-align: top; width: 48px; padding-right:
8px; }
    #email-title-flavor { margin: 0; padding: 0 0 4px 0; }
    #email-title-heading { font-size: 16px; line-height: 20px; min-height: 20px; margin: 0;
padding: 0; }
    #email-title .icon { border: 0; padding: 0 5px 0 0; text-align: left; vertical-align:
middle; }

    #email-actions { border-top: 1px solid #bbb; color: #505050; margin: 8px 0 0 0; padding:
0; }
    #email-actions td { padding-top: 8px; }
    #email-actions .left { max-width: 45%; text-align: left; }
    #email-actions .right { text-align: right; }
    .email-reply-divider { border-top: 1px solid #bbb; color: #505050; margin: 32px 0 8px
0; padding: 8px 0; }
    .email-section-title { border-bottom: 1px solid #bbb; margin: 8px 0; padding: 8px 0 0
0; }

    .email-metadata { color: #505050; }

    a { color: #326ca6; text-decoration: none; }
    a:hover { color: #336ca6; text-decoration: underline; }
    a:active {color: #326ca6; }

    a.email-footer-link { color: #505050; font-size: 11px; }

    .email-item-list { list-style: none; margin: 4px 0; padding-left: 0; }
    .email-item-list li { list-style: none; margin: 0; padding: 4px 0; }
    .email-list-divider { color: #505050; padding: 0 0.35em; }
    .email-operation-icon { padding-right: 5px; }

    .avatar { -ms-interpolation-mode: bicubic; border-radius: 3px;}
    .avatar-link { margin: 2px; }

    .tableview th { border-bottom: 1px solid #69C; font-weight: bold; text-align: left; }
    .tableview td { border-bottom: 1px solid #bbbbbb; text-align: left; padding: 4px 16px
4px 0; }

    .aui-message {  margin: 1em 0; padding: 8px; }
    .aui-message.info { background-color: #e0f0ff; border: 1px solid #9eb6d4; }
    .aui-message.success { background-color: #ddfade; border: 1px solid #93c49f; }
    .aui-message.error,
    .aui-message.removed { background-color: #ffe7e7; border: 1px solid #df9898; color: #000;
}

    .call-to-action-table { margin: 10px 1px 1px 1px;}
    .call-to-cancel-container, .call-to-action-container { padding: 5px 20px; }
    .call-to-cancel-container { border: 1px solid #aaa; background-color: #eee; border-radius:
3px; }
    .call-to-cancel-container a.call-to-cancel-button { background-color: #eee; font-size:
14px; line-height: 1; padding: 0; margin: 0; color: #666; font-family: sans-serif;}
    .call-to-action-container { border: 1px solid #486582;  background-color: #3068A2; border-radius:
3px; padding: 4px 10px; }
    .call-to-action-container a.call-to-action-button { background-color: #3068A2; font-size:
14px; line-height: 1; padding: 0; margin: 0; color: #fff; font-weight: bold; font-family:
sans-serif; }

    /** The span around the inline task checkbox image */
    .diff-inline-task-overlay {
        display: inline-block;
        text-align: center;
        height: 1.5em;
        padding: 5px 0px 1px 5px;
        margin-right: 5px;
        /** Unfortunately, the negative margin-left is stripped out in gmail */
        margin-left: -5px;
    }

            @media handheld, only screen and (max-device-width: 480px) {
        div, a, p, td, th, li, dt, dd { -webkit-text-size-adjust: auto; }
        small, small a { -webkit-text-size-adjust: 90%; }

        td[id=email-wrapper-inner] { padding: 2px !important; }
        td[id=email-content-inner] { padding: 8px !important; }
        td[id="email-wrapper-inner"][class="thin"] > table { text-align: left !important;
width: 100% !important; }
        td[id=email-footer] { padding: 8px 12px !important; }
        div[class=email-indent] { margin: 8px 0px !important; }
        div[class=email-comment] { margin: 0 !important; }

        p[id=email-title-flavor] a { display: block; } /* puts the username and the action
on separate lines */
        p[id=email-permalink] { padding: 4px 0 0 0 !important; }

        table[id=email-actions] td { padding-top: 0 !important; }
        table[id=email-actions] td.right { text-align: right !important; }
        table[id=email-actions] .email-list-item { display: block; margin: 1em 0 !important;
word-wrap: normal !important; }
        span[class=email-list-divider] { display: none; }
    }



        </style>
    </head>
    <body style="font-family: Arial, FreeSans, Helvetica, sans-serif; font-size: 13px;
width: 100%; -webkit-font-smoothing: antialiased; background-color: #f0f0f0">
        <table id="email-wrapper" width="100%" cellspacing="0" cellpadding="0" border="0"
style="background-color: #f0f0f0">
            <tbody>
                <tr valign="middle">
                    <td id="email-wrapper-inner" style="font-size: 13px; padding: 20px;
text-align: center">
                        <table id="email-content" cellspacing="0" cellpadding="0" border="0"
style="font-family: Arial, FreeSans, Helvetica, sans-serif; width: 100%">
                            <tbody>
                                <tr valign="top">
                                    <td id="email-content-inner" align="left" style="font-family:
Arial, FreeSans, Helvetica, sans-serif; font-size: 13px; background-color: #fff; border: 1px
solid #bbb; padding: 20px; text-align: left">
                                        <table id="email-title" cellpadding="0" cellspacing="0"
border="0" width="100%">
                                            <tbody>
                                                <tr>
                                                    <td id="email-title-avatar" rowspan="2"
style="font-size: 13px; text-align: left; vertical-align: top; width: 48px; padding-right:
8px"> <img class="avatar" src="cid:avatar_acf9e33a752338c5b13b322c0539cacd" border="0"
height="48" width="48" style="-ms-interpolation-mode: bicubic; border-radius: 3px" /> </td>
                                                    <td valign="top" style="font-size:
13px">
                                                        <div id="email-title-flavor" class="email-metadata"
style="margin: 0; padding: 0 0 4px 0; color: #505050">
                                                            <a href="    https://cwiki.apache.org/confluence/display/~dkulp
" style="color:#326ca6;text-decoration:none;; color: #326ca6; text-decoration: none">Daniel
Kulp</a> removed the page:
                                                        </div> </td>
                                                </tr>
                                                <tr>
                                                    <td valign="top" style="font-size:
13px"> <h2 id="email-title-heading" style="font-size: 16px; line-height: 20px; min-height:
20px; margin: 0; padding: 0"> <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Running+a+3.x+Broker"
style="color: #326ca6; text-decoration: none"> <img class="icon" src="cid:page-icon"
alt="" style="border: 0; padding: 0 5px 0 0; text-align: left; vertical-align: middle" />
<strong style="font-size:16px;line-height:20px;vertical-align:top;">Running a 3.x Broker</strong>
</a> </h2> </td>
                                                </tr>
                                            </tbody>
                                        </table>
                                        <div class="email-indent" style="margin: 8px 0
16px 0">
                                            <div class="email-page removed">
                                                <p style="font-size: 13px">The 3.x <a
href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Download" style="color: #326ca6;
text-decoration: none">binary distribution</a> of ActiveMQ comes with a script called
'activemq' which allows you to run a broker. Typing the following will run an ActiveMQ Broker
using the out of the box configuration</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
activemq
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">You can use
the <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Xml+Configuration" style="color:
#326ca6; text-decoration: none">Xml Configuration</a> to customize the Message Broker
to suit your needs. You can run a broker with a specific XML configuration as</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
activemq foo.xml
</pre>
                                                    </div>
                                                </div>
                                                <h3 id="Runninga3.xBroker-RunningthebrokerinsideaServletEngine.3">Running
the broker inside a Servlet Engine</h3>
                                                <p style="font-size: 13px">If you have
the binary distribution (3.1 onwards) you can run the broker using a WAR distribution. From
the binary download type the following</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
cd example
ant war
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">and you get
a war in the target directory capable of being deployed in a servlet engine. This has been
tried in Resin, Tomcat 4.x, 5.x, Jetty 5.x and should work in most good servlet engines. See
the Ant build for details and web.xml of how this works if you wish to integrate this into
your WAR.</p>
                                                <h3 id="Runninga3.xBroker-RunningthebrokerinsideyourJ2EE1.4ApplicationServer.3">Running
the broker inside your J2EE 1.4 Application Server</h3>
                                                <p style="font-size: 13px">Whether its
Apache Geronmio, JBoss 4, WebLogic 9 or some other J2EE 1.4 container you should be able to
just deploy the activemq-*.rar which is included in the binary distribution as a deployment
unit in your app server.</p>
                                                <h3 id="Runninga3.xBroker-Runningthe3.xbrokerfromthesourcecode.3">Running
the 3.x broker from the source code</h3>
                                                <p style="font-size: 13px">You can do
this by running the main() in the <a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/broker/impl/Main.html"
class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none">org.activemq.broker.impl.Main</a>
class inside your IDE, assuming you've <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Initial+Configuration"
style="color: #326ca6; text-decoration: none">set up your classpath</a> properly.</p>
                                                <p style="font-size: 13px">Another option,
if you have a <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Building" style="color:
#326ca6; text-decoration: none">source distribution</a>, is to run the broker from
inside Maven by typing</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
cd modules/assembly
maven server
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">You can specify
a URL to listen on by specifying a parameter, such as</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
java org.activemq.broker.impl.Main tcp://localhost:61626
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">Or via Maven</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
maven server -Durl=tcp://localhost:61626
</pre>
                                                    </div>
                                                </div>
                                                <h3 id="Runninga3.xBroker-UsingtheXMLconfiguration.3">Using
the XML configuration</h3>
                                                <p style="font-size: 13px">You can use
the <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Xml+Configuration" style="color:
#326ca6; text-decoration: none">Xml Configuration</a> to customize the Message Broker
to suit your needs. You can run a broker from Maven as follows...</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
maven server -Dconfig=src/sample-conf/default.xml
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">If your <a
href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Initial+Configuration" style="color:
#326ca6; text-decoration: none">classpath is setup correctly</a> you can achieve
the same thing from the command line</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
java org.activemq.spring.Main src/sample-conf/default.xml
</pre>
                                                    </div>
                                                </div>
                                                <p style="font-size: 13px">Notice that
we supply an alternative Main which is dependent on Spring and takes an XML configuration
file as the argument.</p>
                                                <h2 id="Runninga3.xBroker-HandlingJMSbrokersgoingdown.3">Handling
JMS brokers going down</h2>
                                                <p style="font-size: 13px">A common
requirement is that if the JMS broker goes down you want to automatically detect the failure
and try to reconnect under the covers so that your application does not have to worry about
reconnection.</p>
                                                <p style="font-size: 13px">There is
detailed documentation on this in <a href="https://cwiki.apache.org/confluence/display/ACTIVEMQ/Configuring+Transports"
style="color: #326ca6; text-decoration: none">Configuring Transports</a>; briefly...</p>
                                                <p style="font-size: 13px">Just change
your connection URI in 3.x to</p>
                                                <div class="code panel pdl" style="border-width:
1px;">
                                                    <div class="codeContent panelContent
pdl">
                                                        <pre class="theme: Default; brush:
java; gutter: false" style="font-size:12px;; font-size: 13px">
reliable:tcp://host:port
</pre>
                                                    </div>
                                                </div>
                                            </div>
                                        </div>
                                        <table id="email-actions" class="email-metadata"
cellspacing="0" cellpadding="0" border="0" width="100%" style="border-top: 1px solid #bbb;
color: #505050; margin: 8px 0 0 0; padding: 0; color: #505050">
                                            <tbody>
                                                <tr>
                                                    <td class="left" valign="top" style="font-size:
13px; padding-top: 8px; max-width: 45%; text-align: left"> </td>
                                                    <td class="right" width="50%" valign="top"
style="font-size: 13px; padding-top: 8px; text-align: right"> <span class="email-list-item"><a
href="https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=ACTIVEMQ"
style="color: #326ca6; text-decoration: none">Stop watching space</a> </span>
<span class="email-list-divider" style="color: #505050; padding: 0 0.350em">&middot;</span>
<span class="email-list-item"><a href="https://cwiki.apache.org/confluence/users/editmyemailsettings.action"
style="color: #326ca6; text-decoration: none">Manage Notifications</a> </span>
</td>
                                                </tr>
                                            </tbody>
                                        </table> </td>
                                </tr>
                            </tbody>
                        </table> </td>
                </tr>
                <tr>
                    <td id="email-footer" align="center" style="font-size: 13px; padding:
0 16px 32px 16px; margin: 0"> <small style="font-size: 11px"> This message was sent
by <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;;
color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence">Atlassian
Confluence</a> 5.0.3, <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;;
color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence/overview/team-collaboration-software?utm_source=email-footer">Team
Collaboration Software</a> </small> </td>
                </tr>
            </tbody>
        </table>
    </body>
</html>
Mime
View raw message