activemq-artemis/examples/features/clustered/client-side-load-balancing/readme.html

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
-->

<html>
  <head>
    <title>ActiveMQ Artemis JMS Client-Side Load-Balancing Example</title>
    <link rel="stylesheet" type="text/css" href="../../../common/common.css" />
    <link rel="stylesheet" type="text/css" href="../../../common/prettify.css" />
    <script type="text/javascript" src="../../../common/prettify.js"></script>
  </head>
  <body onload="prettyPrint()">
     <h1>JMS Client-Side Load-Balancing Example</h1>
     <pre>To run the example, simply type <b>mvn verify</b> from this directory, <br>or <b>mvn -PnoServer verify</b> if you want to start and create the server manually.</pre>

     <p>This example demonstrates how connnections created from a single JMS Connection factory can be created
     to different nodes of the cluster. In other words it demonstrates how ActiveMQ Artemis does <b>client side load balancing</b> of
     connections across the cluster.</p>
     <p>The particular load-balancing policy can be chosen to be random, round-robin or user-defined. Please see the user
     guide for more details of how to configure the specific load-balancing policy. In this example we will use
     the default round-robin load balancing policy.</p>
     <p>The list of servers over which ActiveMQ Artemis will round-robin the connections can either be specified explicitly
     in the connection factory when instantiating it directly, when configuring it on the server or configured
     to use UDP discovery to discover the list of servers over which to round-robin. This example will use UDP
     discovery to obtain the list.</p>
     <p>This example starts three servers which all broadcast their location using UDP discovery. The UDP broadcast configuration
     can be seen in the <code>broker.xml</code> file.</p>
     <p>A JMS ConnectionFactory is deployed on each server specifying the discovery group that will be used by that
     connection factory.</p>
     <p>For more information on ActiveMQ Artemis load balancing, and clustering in general, please see the clustering
     section of the user manual.</p>

   </body>
</html>
ACTIVEMQ6-43(reopened) : Replace License Headers on codebase - added missing license headers found by maven rat plugin. most of them added automatically via apache-rat a few manually added - added apache-rat maven plugin to the build cycle 2015-01-05 07:45:36 -05:00			`<!--`
			`Licensed to the Apache Software Foundation (ASF) under one`
			`or more contributor license agreements. See the NOTICE file`
			`distributed with this work for additional information`
			`regarding copyright ownership. The ASF licenses this file`
			`to you under the Apache License, Version 2.0 (the`
			`"License"); you may not use this file except in compliance`
			`with the License. You may obtain a copy of the License at`

			`http://www.apache.org/licenses/LICENSE-2.0`

			`Unless required by applicable law or agreed to in writing,`
			`software distributed under the License is distributed on an`
			`"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY`
			`KIND, either express or implied. See the License for the`
			`specific language governing permissions and limitations`
			`under the License.`
			`-->`

ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00			`<html>`
			`<head>`
Ensure all references to the project use ActiveMQ Artemis 2015-05-13 06:12:07 -04:00			`<title>ActiveMQ Artemis JMS Client-Side Load-Balancing Example</title>`
This commit has improvements on the examples including: https://issues.apache.org/jira/browse/ARTEMIS-113 Better organize examples https://issues.apache.org/jira/browse/ARTEMIS-114 Some openwire examples 2015-08-10 10:41:52 -04:00			`<link rel="stylesheet" type="text/css" href="../../../common/common.css" />`
			`<link rel="stylesheet" type="text/css" href="../../../common/prettify.css" />`
			`<script type="text/javascript" src="../../../common/prettify.js"></script>`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00			`</head>`
			`<body onload="prettyPrint()">`
			`<h1>JMS Client-Side Load-Balancing Example</h1>`
ARTEMIS-180 removing -Pexample and some other improvements around the examples 2015-08-05 15:33:20 -04:00			`<pre>To run the example, simply type <b>mvn verify</b> from this directory, <br>or <b>mvn -PnoServer verify</b> if you want to start and create the server manually.</pre>`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00
			`<p>This example demonstrates how connnections created from a single JMS Connection factory can be created`
Ensure all references to the project use ActiveMQ Artemis 2015-05-13 06:12:07 -04:00			`to different nodes of the cluster. In other words it demonstrates how ActiveMQ Artemis does <b>client side load balancing</b> of`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00			`connections across the cluster.</p>`
			`<p>The particular load-balancing policy can be chosen to be random, round-robin or user-defined. Please see the user`
			`guide for more details of how to configure the specific load-balancing policy. In this example we will use`
			`the default round-robin load balancing policy.</p>`
Ensure all references to the project use ActiveMQ Artemis 2015-05-13 06:12:07 -04:00			`<p>The list of servers over which ActiveMQ Artemis will round-robin the connections can either be specified explicitly`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00			`in the connection factory when instantiating it directly, when configuring it on the server or configured`
			`to use UDP discovery to discover the list of servers over which to round-robin. This example will use UDP`
			`discovery to obtain the list.</p>`
			`<p>This example starts three servers which all broadcast their location using UDP discovery. The UDP broadcast configuration`
renamed config to broker.xml 2015-04-29 05:30:31 -04:00			`can be seen in the <code>broker.xml</code> file.</p>`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00			`<p>A JMS ConnectionFactory is deployed on each server specifying the discovery group that will be used by that`
ARTEMIS-180 removing -Pexample and some other improvements around the examples 2015-08-05 15:33:20 -04:00			`connection factory.</p>`
Ensure all references to the project use ActiveMQ Artemis 2015-05-13 06:12:07 -04:00			`<p>For more information on ActiveMQ Artemis load balancing, and clustering in general, please see the clustering`
ARTEMIS-180 removing -Pexample and some other improvements around the examples 2015-08-05 15:33:20 -04:00			`section of the user manual.</p>`
ACTIVEMQ6-1 - Initial HornetQ Donation Commit https://issues.apache.org/jira/browse/ACTIVEMQ6-1 This is the initial donation of the HornetQ codebase as per document http://incubator.apache.org/ip-clearance/hornetq.html 2014-10-31 06:20:28 -04:00
ARTEMIS-180 removing -Pexample and some other improvements around the examples 2015-08-05 15:33:20 -04:00			`</body>`
ACTIVEMQ6-43(reopened) : Replace License Headers on codebase - added missing license headers found by maven rat plugin. most of them added automatically via apache-rat a few manually added - added apache-rat maven plugin to the build cycle 2015-01-05 07:45:36 -05:00			`</html>`