You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by gt...@apache.org on 2020/07/23 13:21:59 UTC
[activemq-website] branch master updated: link in and refresh
migration guide and add reference to the command line tool project for
message store migration
This is an automated email from the ASF dual-hosted git repository.
gtully pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/activemq-website.git
The following commit(s) were added to refs/heads/master by this push:
new 894384c link in and refresh migration guide and add reference to the command line tool project for message store migration
894384c is described below
commit 894384c509476ce416ebe309d9ceeef92728ea77
Author: gtully <ga...@gmail.com>
AuthorDate: Thu Jul 23 14:21:42 2020 +0100
link in and refresh migration guide and add reference to the command line tool project for message store migration
---
content/components/artemis/index.html | 43 ++-
.../migration-documentation/VirtualTopics.html | 413 +++++++++++++++++++++
.../migration-documentation/authentication.html | 74 +++-
.../migration-documentation/authorization.html | 70 +++-
.../migration-documentation/configuration.html | 76 +++-
.../migration-documentation/connectors.html | 70 +++-
.../migration-documentation/destinations.html | 74 +++-
.../migration-documentation/gitbook/gitbook.js | 4 +-
.../migration-documentation/gitbook/theme.js | 2 +-
.../images/artemis-logo.png | Bin 0 -> 21601 bytes
.../artemis/migration-documentation/index.html | 92 +++--
.../{index.html => key-differences.html} | 93 ++++-
.../{notice.html => message-store.html} | 101 +++--
.../artemis/migration-documentation/notice.html | 74 +++-
.../artemis/migration-documentation/preface.html | 102 +++--
.../migration-documentation/search_index.json | 2 +-
.../artemis/migration-documentation/ssl.html | 74 +++-
src/components/artemis/index.html | 44 ++-
.../migration-documentation/VirtualTopics.html | 413 +++++++++++++++++++++
.../migration-documentation/authentication.html | 74 +++-
.../migration-documentation/authorization.html | 70 +++-
.../migration-documentation/configuration.html | 76 +++-
.../migration-documentation/connectors.html | 70 +++-
.../migration-documentation/destinations.html | 74 +++-
.../migration-documentation/gitbook/gitbook.js | 4 +-
.../migration-documentation/gitbook/theme.js | 2 +-
.../images/artemis-logo.png | Bin 0 -> 21601 bytes
.../artemis/migration-documentation/index.html | 92 +++--
.../migration-documentation/key-differences.html | 93 ++++-
.../migration-documentation/message-store.html | 101 +++--
.../artemis/migration-documentation/notice.html | 74 +++-
.../{notice.html => preface.html} | 102 +++--
.../migration-documentation/search_index.json | 2 +-
.../artemis/migration-documentation/ssl.html | 74 +++-
34 files changed, 2341 insertions(+), 388 deletions(-)
diff --git a/content/components/artemis/index.html b/content/components/artemis/index.html
index eba7c2d..b3f9326 100644
--- a/content/components/artemis/index.html
+++ b/content/components/artemis/index.html
@@ -105,7 +105,6 @@
<div class="row project-narative">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple">
@@ -121,11 +120,6 @@
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="/assets/img/example-diagram.png"/>
- </div>
- </div-->
</div>
</div>
</div>
@@ -137,7 +131,6 @@
<div class="row project-narative-alt">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple project-narative-alt">
@@ -153,11 +146,6 @@
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="/assets/img/example-diagram.png"/>
- </div>
- </div-->
</div>
</div>
</div>
@@ -169,7 +157,6 @@
<div class="row project-narative">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple">
@@ -185,11 +172,32 @@
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="/assets/img/example-diagram.png"/>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+</div>
+<div class="row project-narative-alt">
+ <div class="col-12">
+ <div class="container">
+ <div class="row">
+ <div class="col-12">
+ <div class="card card-purple project-narative-alt">
+ <div class="card-body">
+ <div class="row">
+ <div class="col-sm-12 col-md-8">
+ <div class="card">
+ <div class="card-body project-narative-alt">
+ <h5 class="card-title text-purple">Guide for Migration to ActiveMQ Artemis</h5>
+ <h6>Easily migrate from ActiveMQ 5</h6>
+ <p>ActiveMQ Artemis has analogues to all of the ActiveMQ 5 core features and full support for the ActiveMQ 5 OpenWire protocol.</p>
+ <a style="margin-top: 10px" href="migration" class="btn btn-warning">Find out more<i class="fa-info-circle fa btn-icon"></i></a>
+ </div>
</div>
- </div-->
+ </div>
</div>
</div>
</div>
@@ -198,7 +206,6 @@
</div>
</div>
</div>
-
</div>
<div class="row sitemap">
<div class="col-sm-12">
diff --git a/content/components/artemis/migration-documentation/VirtualTopics.html b/content/components/artemis/migration-documentation/VirtualTopics.html
new file mode 100644
index 0000000..24126d7
--- /dev/null
+++ b/content/components/artemis/migration-documentation/VirtualTopics.html
@@ -0,0 +1,413 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+ <head>
+ <meta charset="UTF-8">
+ <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+ <title>Virtual Topics · ActiveMQ Artemis Documentation</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+ <meta name="description" content="">
+ <meta name="generator" content="GitBook 3.2.3">
+
+
+
+
+ <link rel="stylesheet" href="gitbook/style.css">
+
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <meta name="HandheldFriendly" content="true"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black">
+ <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+ <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+
+ <link rel="next" href="authentication.html" />
+
+
+ <link rel="prev" href="destinations.html" />
+
+
+ </head>
+ <body>
+
+<div class="book">
+ <div class="book-summary">
+
+
+<div id="book-search-input" role="search">
+ <input type="text" placeholder="Type to search" />
+</div>
+
+
+ <nav role="navigation">
+
+
+
+<ul class="summary">
+
+
+
+
+
+
+
+
+
+ <li class="chapter " data-level="1.1" data-path="./">
+
+ <a href="./">
+
+
+ Introduction
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
+
+ <a href="configuration.html">
+
+
+ Configuration
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
+
+ <a href="connectors.html">
+
+
+ Connectors
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
+
+ <a href="destinations.html">
+
+
+ Destinations
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
+
+ <a href="authentication.html">
+
+
+ Authentication
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
+
+ <a href="authorization.html">
+
+
+ Authorization
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
+
+ <a href="ssl.html">
+
+
+ SSL
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
+
+ <a href="notice.html">
+
+
+ Legal Notice
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="divider"></li>
+
+ <li>
+ <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+ Published with GitBook
+ </a>
+ </li>
+</ul>
+
+
+ </nav>
+
+
+ </div>
+
+ <div class="book-body">
+
+ <div class="body-inner">
+
+
+
+<div class="book-header" role="navigation">
+
+
+ <!-- Title -->
+ <h1>
+ <i class="fa fa-circle-o-notch fa-spin"></i>
+ <a href="." >Virtual Topics</a>
+ </h1>
+</div>
+
+
+
+
+ <div class="page-wrapper" tabindex="-1" role="main">
+ <div class="page-inner">
+
+<div id="book-search-results">
+ <div class="search-noresults">
+
+ <section class="normal markdown-section">
+
+ <h1 id="virtual-topics">Virtual Topics</h1>
+<p>Virtual Topics (a specialisation of virtual destinations) in ActiveMQ 5.x typically address two different but related
+problems. Lets take each in turn:</p>
+<h2 id="shared-access-to-a-jms-durable-topic-subscription">Shared access to a JMS durable topic subscription</h2>
+<p>With JMS1.1, a durable subscription is identified by the pair of clientId and subscriptionName. The clientId
+component must be unique to a connection on the broker. This means that the subscription is exclusive. It is
+not possible to load balance the stream of messages across consumers and quick failover is difficult because the
+existing connection state on the broker needs to be first disposed.
+With virtual topics, each subscription's stream of messages is redirected to a queue.</p>
+<p>In Artemis there are two alternatives, the new JMS 2.0 api or direct access to a subscription queue via the FQQN.</p>
+<h2 id="jms-20-shared-subscriptions">JMS 2.0 shared subscriptions</h2>
+<p>JMS 2.0 adds the possibility of shared subscriptions with new API's that are fully supported in Artemis.</p>
+<h2 id="fully-qualified-queue-name-fqqn">Fully Qualified Queue name (FQQN)</h2>
+<p>Secondly, Artemis uses a queue per topic subscriber model internally and it is possibly to directly address the
+subscription queue using its Fully Qualified Queue name (FQQN).</p>
+<p>For example, a default 5.x consumer destination for topic <code>VirtualTopic.Orders</code> subscription <code>A</code>:</p>
+<pre><code> ...
+ Queue subscriptionQueue = session.createQueue("Consumer.A.VirtualTopic.Orders");
+ session.createConsumer(subscriptionQueue);
+</code></pre><p>would be replaced with an Artemis FQQN comprised of the address and queue.</p>
+<pre><code> ...
+ Queue subscriptionQueue = session.createQueue("VirtualTopic.Orders::Consumer.A.VirtualTopic.Orders");
+ session.createConsumer(subscriptionQueue);
+</code></pre><p>This does require modification to the destination name used by consumers which is not ideal.
+If OpenWire clients cannot be modified, Artemis supports a virtual topic wildcard filter
+mechanism on the OpenWire protocol handler that will automatically convert the consumer destination into the
+corresponding FQQN.
+The format is a comma separated list of strings pairs, delimited with a ';'. Each pair identifies a filter to match
+the virtual topic consumer destination and an int that specifies the number of path matches that terminate the consumer
+queue identity.</p>
+<p>E.g: For the default 5.x virtual topic consumer prefix of <code>Consumer.*.</code> the parameter <code>virtualTopicConsumerWildcards</code> should be: <code>Consumer.*.>;2</code>.
+However, there is a caveat because this value needs to be encoded in a uri for the xml configuration. Any unsafe url characters
+, in this case: <code>> ;</code> need to be escaped with their hex code point representation; leading to a value of <code>Consumer.*.%3E%3B2</code>.
+In this way a consumer destination of <code>Consumer.A.VirtualTopic.Orders</code> will be transformed into a FQQN of
+<code>VirtualTopic.Orders::Consumer.A.VirtualTopic.Orders</code>.</p>
+<h2 id="durable-topic-subscribers-in-a-network-of-brokers">Durable topic subscribers in a network of brokers</h2>
+<p>The store and forward network bridges in 5.x create a durable subscriber per destination. As demand migrates across a
+network, duplicate durable subs get created on each node in the network but they do not migrate. The end result can
+result in duplicate message storage and ultimately duplicate delivery, which is not good.
+When durable subscribers map to virtual topic subscriber queues, the queues can migrate and the problem can be avoided.</p>
+<p>In Artemis, because a durable sub is modeled as a queue, this problem does not arise.</p>
+
+
+ </section>
+
+ </div>
+ <div class="search-results">
+ <div class="has-results">
+
+ <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+ <ul class="search-results-list"></ul>
+
+ </div>
+ <div class="no-results">
+
+ <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+
+ </div>
+ </div>
+</div>
+
+ </div>
+ </div>
+
+ </div>
+
+
+
+ <a href="destinations.html" class="navigation navigation-prev " aria-label="Previous page: Destinations">
+ <i class="fa fa-angle-left"></i>
+ </a>
+
+
+ <a href="authentication.html" class="navigation navigation-next " aria-label="Next page: Authentication">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
+
+
+ </div>
+
+ <script>
+ var gitbook = gitbook || [];
+ gitbook.push(function() {
+ gitbook.page.hasChanged({"page":{"title":"Virtual Topics","level":"1.7","depth":1,"next":{"title":"Authentication","level":"1.8","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"previous":{"title":"Destinations","level":"1.6","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css", [...]
+ });
+ </script>
+</div>
+
+
+ <script src="gitbook/gitbook.js"></script>
+ <script src="gitbook/theme.js"></script>
+
+
+ <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-search/search.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+
+
+
+ </body>
+</html>
+
diff --git a/content/components/artemis/migration-documentation/authentication.html b/content/components/artemis/migration-documentation/authentication.html
index 4647243..0fe0142 100644
--- a/content/components/artemis/migration-documentation/authentication.html
+++ b/content/components/artemis/migration-documentation/authentication.html
@@ -7,7 +7,7 @@
<title>Authentication · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,7 +60,7 @@
<link rel="next" href="authorization.html" />
- <link rel="prev" href="destinations.html" />
+ <link rel="prev" href="VirtualTopics.html" />
</head>
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter active" data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -279,7 +331,7 @@
- <a href="destinations.html" class="navigation navigation-prev " aria-label="Previous page: Destinations">
+ <a href="VirtualTopics.html" class="navigation navigation-prev " aria-label="Previous page: Virtual Topics">
<i class="fa fa-angle-left"></i>
</a>
@@ -295,7 +347,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Authentication","level":"1.5","depth":1,"next":{"title":"Authorization","level":"1.6","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"previous":{"title":"Destinations","level":"1.4","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","eb [...]
+ gitbook.page.hasChanged({"page":{"title":"Authentication","level":"1.8","depth":1,"next":{"title":"Authorization","level":"1.9","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"previous":{"title":"Virtual Topics","level":"1.7","depth":1,"path":"VirtualTopics.md","ref":"VirtualTopics.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css" [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/authorization.html b/content/components/artemis/migration-documentation/authorization.html
index b0c0b53..88730b3 100644
--- a/content/components/artemis/migration-documentation/authorization.html
+++ b/content/components/artemis/migration-documentation/authorization.html
@@ -7,7 +7,7 @@
<title>Authorization · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter active" data-level="1.6" data-path="authorization.html">
+ <li class="chapter active" data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -428,7 +480,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Authorization","level":"1.6","depth":1,"next":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"previous":{"title":"Authentication","level":"1.5","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css"," [...]
+ gitbook.page.hasChanged({"page":{"title":"Authorization","level":"1.9","depth":1,"next":{"title":"SSL","level":"1.10","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"previous":{"title":"Authentication","level":"1.8","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css", [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/configuration.html b/content/components/artemis/migration-documentation/configuration.html
index 9d7ad67..c625d48 100644
--- a/content/components/artemis/migration-documentation/configuration.html
+++ b/content/components/artemis/migration-documentation/configuration.html
@@ -7,7 +7,7 @@
<title>Configuration · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,7 +60,7 @@
<link rel="next" href="connectors.html" />
- <link rel="prev" href="./" />
+ <link rel="prev" href="key-differences.html" />
</head>
@@ -102,7 +102,33 @@
</li>
- <li class="chapter active" data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -253,7 +305,7 @@
<p>Let's take a look now at the configuration in more details. The entry <code>etc/bootstrap.xml</code> file is here to set the basics, like the location of the main broker configuration file, utility apps like a web server and JAAS security.</p>
<p>The main configuration file is <code>etc/broker.xml</code>. Similarly to ActiveMQ's <code>conf/activemq.xml</code>, this is where you configure most of the aspects of the broker, like connector ports, destination names, security policies, etc. We will go through this file in details in the following articles.</p>
<p>The <code>etc/artemis.profile</code> file is similar to the <code>bin/env</code> file in ActiveMQ. Here you can configure environment variables for the broker, mostly regular JVM args related to SSL context, debugging, etc.</p>
-<p>There's no much difference in logging configuration between two brokers, so anyone familiar with Java logging systems in general will find herself at home here. The <code>etc/logging.properties</code> file is where it's all configured.</p>
+<p>There's not much difference in logging configuration between two brokers, so anyone familiar with Java logging systems in general will find herself at home here. The <code>etc/logging.properties</code> file is where it's all configured.</p>
<p>Finally, we have JAAS configuration files (<code>login.config</code>, <code>artemis-users.properties</code> and <code>artemis-roles.properties</code>), which cover same roles as in ActiveMQ and we will go into more details on these in the article that covers security.</p>
<p>After this brief walk through the location of different configuration aspects of Artemis, we're ready to start the broker. If you wish to start the broker in the foreground, you should execute</p>
<pre><code class="lang-sh">$ bin/artemis run
@@ -304,7 +356,7 @@ $ bin/activemq consumer
- <a href="./" class="navigation navigation-prev " aria-label="Previous page: Introduction">
+ <a href="key-differences.html" class="navigation navigation-prev " aria-label="Previous page: Key Differences">
<i class="fa fa-angle-left"></i>
</a>
@@ -320,7 +372,7 @@ $ bin/activemq consumer
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Configuration","level":"1.2","depth":1,"next":{"title":"Connectors","level":"1.3","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"previous":{"title":"Introduction","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css [...]
+ gitbook.page.hasChanged({"page":{"title":"Configuration","level":"1.4","depth":1,"next":{"title":"Connectors","level":"1.5","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"previous":{"title":"Key Differences","level":"1.3","depth":1,"path":"key-differences.md","ref":"key-differences.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebo [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/connectors.html b/content/components/artemis/migration-documentation/connectors.html
index 5c46cec..6a36def 100644
--- a/content/components/artemis/migration-documentation/connectors.html
+++ b/content/components/artemis/migration-documentation/connectors.html
@@ -7,7 +7,7 @@
<title>Connectors · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter active" data-level="1.3" data-path="connectors.html">
+ <li class="chapter active" data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -346,7 +398,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Connectors","level":"1.3","depth":1,"next":{"title":"Destinations","level":"1.4","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"previous":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook" [...]
+ gitbook.page.hasChanged({"page":{"title":"Connectors","level":"1.5","depth":1,"next":{"title":"Destinations","level":"1.6","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"previous":{"title":"Configuration","level":"1.4","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook" [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/destinations.html b/content/components/artemis/migration-documentation/destinations.html
index 62222de..df1926b 100644
--- a/content/components/artemis/migration-documentation/destinations.html
+++ b/content/components/artemis/migration-documentation/destinations.html
@@ -7,7 +7,7 @@
<title>Destinations · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="authentication.html" />
+ <link rel="next" href="VirtualTopics.html" />
<link rel="prev" href="connectors.html" />
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter active" data-level="1.4" data-path="destinations.html">
+ <li class="chapter active" data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -293,7 +345,7 @@
</a>
- <a href="authentication.html" class="navigation navigation-next " aria-label="Next page: Authentication">
+ <a href="VirtualTopics.html" class="navigation navigation-next " aria-label="Next page: Virtual Topics">
<i class="fa fa-angle-right"></i>
</a>
@@ -304,7 +356,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Destinations","level":"1.4","depth":1,"next":{"title":"Authentication","level":"1.5","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"previous":{"title":"Connectors","level":"1.3","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook": [...]
+ gitbook.page.hasChanged({"page":{"title":"Destinations","level":"1.6","depth":1,"next":{"title":"Virtual Topics","level":"1.7","depth":1,"path":"VirtualTopics.md","ref":"VirtualTopics.md","articles":[]},"previous":{"title":"Connectors","level":"1.5","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"s [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/gitbook/gitbook.js b/content/components/artemis/migration-documentation/gitbook/gitbook.js
index 10000c7..13077b4 100644
--- a/content/components/artemis/migration-documentation/gitbook/gitbook.js
+++ b/content/components/artemis/migration-documentation/gitbook/gitbook.js
@@ -1,4 +1,4 @@
!function e(t,n,r){function o(s,a){if(!n[s]){if(!t[s]){var u="function"==typeof require&&require;if(!a&&u)return u(s,!0);if(i)return i(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var l=n[s]={exports:{}};t[s][0].call(l.exports,function(e){var n=t[s][1][e];return o(n?n:e)},l,l.exports,e,t,n,r)}return n[s].exports}for(var i="function"==typeof require&&require,s=0;s<r.length;s++)o(r[s]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"objec [...]
return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(xe,be),function(t){return(t.textContent||t.innerText||j(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(xe,be).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.h [...]
-var o=de.isEmptyObject(e),i=de.speed(t,n,r),s=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,o||i.queue===!1?this.each(s):this.queue(i.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,s=Fe.get(this);if(o)s[o]&&s[o].stop&&r(s[o]);else for(o in s)s[o]&&s[o].st [...]
-o}function i(e){return c.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function s(e,t){return o(e,!1,!0).resolve(t)}function a(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),c=e("./util");n.parse=o,n.resolve=s,n.resolveObject=a,n.format=i,n.Url=r;var l=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=["{","}","|","\\","^","`"].concat(h),g=["'"].concat(d),m=["%","/","?",";","#"].c [...]
+var o=de.isEmptyObject(e),i=de.speed(t,n,r),s=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,o||i.queue===!1?this.each(s):this.queue(i.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,s=Fe.get(this);if(o)s[o]&&s[o].stop&&r(s[o]);else for(o in s)s[o]&&s[o].st [...]
+if(e&&c.isObject(e)&&e instanceof r)return e;var o=new r;return o.parse(e,t,n),o}function i(e){return c.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function s(e,t){return o(e,!1,!0).resolve(t)}function a(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),c=e("./util");n.parse=o,n.resolve=s,n.resolveObject=a,n.format=i,n.Url=r;var l=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=[ [...]
diff --git a/content/components/artemis/migration-documentation/gitbook/theme.js b/content/components/artemis/migration-documentation/gitbook/theme.js
index 4c22928..268002a 100644
--- a/content/components/artemis/migration-documentation/gitbook/theme.js
+++ b/content/components/artemis/migration-documentation/gitbook/theme.js
@@ -1,4 +1,4 @@
!function e(t,n,r){function o(a,s){if(!n[a]){if(!t[a]){var u="function"==typeof require&&require;if(!s&&u)return u(a,!0);if(i)return i(a,!0);var l=new Error("Cannot find module '"+a+"'");throw l.code="MODULE_NOT_FOUND",l}var c=n[a]={exports:{}};t[a][0].call(c.exports,function(e){var n=t[a][1][e];return o(n?n:e)},c,c.exports,e,t,n,r)}return n[a].exports}for(var i="function"==typeof require&&require,a=0;a<r.length;a++)o(r[a]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"objec [...]
return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(be,xe),function(t){return(t.textContent||t.innerText||k(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(be,xe).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.h [...]
var o=de.isEmptyObject(e),i=de.speed(t,n,r),a=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return a.finish=a,o||i.queue===!1?this.each(a):this.queue(i.queue,a)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,a=Fe.get(this);if(o)a[o]&&a[o].stop&&r(a[o]);else for(o in a)a[o]&&a[o].st [...]
-r(a,h)?o(a[h])?a[h].push(d):a[h]=[a[h],d]:a[h]=d}return a};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],5:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,s){return t=t||"&",n=n||"=" [...]
+r(a,h)?o(a[h])?a[h].push(d):a[h]=[a[h],d]:a[h]=d}return a};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],5:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,s){return t=t||"&",n=n||"=" [...]
diff --git a/content/components/artemis/migration-documentation/images/artemis-logo.png b/content/components/artemis/migration-documentation/images/artemis-logo.png
new file mode 100644
index 0000000..de602ee
Binary files /dev/null and b/content/components/artemis/migration-documentation/images/artemis-logo.png differ
diff --git a/content/components/artemis/migration-documentation/index.html b/content/components/artemis/migration-documentation/index.html
index d73a17f..d636630 100644
--- a/content/components/artemis/migration-documentation/index.html
+++ b/content/components/artemis/migration-documentation/index.html
@@ -7,7 +7,7 @@
<title>Introduction · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="configuration.html" />
+ <link rel="next" href="preface.html" />
@@ -100,7 +100,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +139,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +152,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +165,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +191,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +204,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +217,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -236,23 +288,9 @@
<section class="normal markdown-section">
- <p><img src="images/artemis-logo.jpg" alt="ActiveMQ Artemis logo"></p>
+ <p><img src="images/artemis-logo.png" alt="ActiveMQ Artemis logo"></p>
<h1 id="apache-activemq-artemis-migration-guide">Apache ActiveMQ Artemis Migration Guide</h1>
-<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
-<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact. This guide will not cover a message store migration. That topic and aspects of migrating clients that use some other protocol will be the subject of [...]
-<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
-<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
-<h2 id="architectural-differences">Architectural differences</h2>
-<p>Although they are designed to do the same job, things are done differently internally. Here are some of the most notable architectural differences you need to be aware of when you're planning the migration.</p>
-<p>In ActiveMQ, we have a few different implementations of the IO connectivity layer, like tcp (synchronous one) and nio (non-blocking one). In Artemis, the IO layer is implemented using Netty, which is a nio framework. This means that there's no more need to choose between different implementations as the non-blocking one is used by default.</p>
-<p>The other important part of every broker is a message store. Most of the ActiveMQ users are familiar with KahaDB. It consists of a message journal for fast sequential storing of messages (and other command packets) and an index for retrieving messages when needed.</p>
-<p>Artemis has its own message store. It consists only of the append-only message journal. Because of the differences in how paging is done, there's no need for the message index. We'll talk more about that in a minute. It's important to say at this point that these two stores are not interchangeable, and data migration if needed must be carefully planed.</p>
-<p>What do we mean by paging differences? Paging is the process that happens when broker can't hold all incoming messages in its memory. The strategy of how to deal with this situation differs between two brokers. ActiveMQ have <em>cursors</em>, which are basically a cache of messages ready to be dispatched to the consumer. It will try to keep all incoming messages in there. When we run out of the the available memory, messages are added to the store, but the caching stops. When the [...]
-<p>In Artemis, things work differently in this regard. The whole message journal is kept in memory and messages are dispatched directly from it. When we run out of memory, messages are paged <em>on the producer side</em> (before they hit the broker). Theay are stored in sequential page files in the same order as they arrived. Once the memory is freed, messages are moved from these page files into the journal. With paging working like this, messages are read from the file journal only whe [...]
-<p>This is one of the main differences between ActiveMQ 5.x and Artemis. It's important to understand it early on as it affects a lot of destination policy settings and how we configure brokers in order to support these scenarios properly. </p>
-<h2 id="addressing-differences">Addressing differences</h2>
-<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as a open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP ar [...]
-<p>Artemis took a different approach. It implements only queues internally and all other messaging concepts are achieved by routing messages to appropriate queue(s) using addresses. Messaging concepts like publish-subscribe (topics) and point-to-point (queues) are implemented using different type of routing mechanisms on addresses. <em>Multicast</em> routing is used to implement <em>publish-subscribe</em> semantics, where all subscribers to a certain address will get their own internal q [...]
+<p>The migration guide outlines how users can migrate an existing ActiveMQ 5 broker installation to ActiveMQ Artemis.</p>
</section>
@@ -281,7 +319,7 @@
- <a href="configuration.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Configuration">
+ <a href="preface.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Preface">
<i class="fa fa-angle-right"></i>
</a>
@@ -292,7 +330,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":100000 [...]
+ gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Preface","level":"1.2","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCh [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/index.html b/content/components/artemis/migration-documentation/key-differences.html
similarity index 69%
copy from content/components/artemis/migration-documentation/index.html
copy to content/components/artemis/migration-documentation/key-differences.html
index d73a17f..ef76996 100644
--- a/content/components/artemis/migration-documentation/index.html
+++ b/content/components/artemis/migration-documentation/key-differences.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Introduction · ActiveMQ Artemis Documentation</title>
+ <title>Key Differences · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,6 +60,8 @@
<link rel="next" href="configuration.html" />
+ <link rel="prev" href="preface.html" />
+
</head>
<body>
@@ -87,7 +89,7 @@
- <li class="chapter active" data-level="1.1" data-path="./">
+ <li class="chapter " data-level="1.1" data-path="./">
<a href="./">
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Introduction</a>
+ <a href="." >Key Differences</a>
</h1>
</div>
@@ -236,12 +290,7 @@
<section class="normal markdown-section">
- <p><img src="images/artemis-logo.jpg" alt="ActiveMQ Artemis logo"></p>
-<h1 id="apache-activemq-artemis-migration-guide">Apache ActiveMQ Artemis Migration Guide</h1>
-<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
-<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact. This guide will not cover a message store migration. That topic and aspects of migrating clients that use some other protocol will be the subject of [...]
-<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
-<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
+ <h1 id="differences-from-activemq-5">Differences From ActiveMQ 5</h1>
<h2 id="architectural-differences">Architectural differences</h2>
<p>Although they are designed to do the same job, things are done differently internally. Here are some of the most notable architectural differences you need to be aware of when you're planning the migration.</p>
<p>In ActiveMQ, we have a few different implementations of the IO connectivity layer, like tcp (synchronous one) and nio (non-blocking one). In Artemis, the IO layer is implemented using Netty, which is a nio framework. This means that there's no more need to choose between different implementations as the non-blocking one is used by default.</p>
@@ -251,7 +300,7 @@
<p>In Artemis, things work differently in this regard. The whole message journal is kept in memory and messages are dispatched directly from it. When we run out of memory, messages are paged <em>on the producer side</em> (before they hit the broker). Theay are stored in sequential page files in the same order as they arrived. Once the memory is freed, messages are moved from these page files into the journal. With paging working like this, messages are read from the file journal only whe [...]
<p>This is one of the main differences between ActiveMQ 5.x and Artemis. It's important to understand it early on as it affects a lot of destination policy settings and how we configure brokers in order to support these scenarios properly. </p>
<h2 id="addressing-differences">Addressing differences</h2>
-<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as a open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP ar [...]
+<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as an open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP a [...]
<p>Artemis took a different approach. It implements only queues internally and all other messaging concepts are achieved by routing messages to appropriate queue(s) using addresses. Messaging concepts like publish-subscribe (topics) and point-to-point (queues) are implemented using different type of routing mechanisms on addresses. <em>Multicast</em> routing is used to implement <em>publish-subscribe</em> semantics, where all subscribers to a certain address will get their own internal q [...]
@@ -280,8 +329,12 @@
+ <a href="preface.html" class="navigation navigation-prev " aria-label="Previous page: Preface">
+ <i class="fa fa-angle-left"></i>
+ </a>
+
- <a href="configuration.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Configuration">
+ <a href="configuration.html" class="navigation navigation-next " aria-label="Next page: Configuration">
<i class="fa fa-angle-right"></i>
</a>
@@ -292,7 +345,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":100000 [...]
+ gitbook.page.hasChanged({"page":{"title":"Key Differences","level":"1.3","depth":1,"next":{"title":"Configuration","level":"1.4","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"previous":{"title":"Preface","level":"1.2","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/e [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/notice.html b/content/components/artemis/migration-documentation/message-store.html
similarity index 53%
copy from content/components/artemis/migration-documentation/notice.html
copy to content/components/artemis/migration-documentation/message-store.html
index 5cd6784..c1a21cf 100644
--- a/content/components/artemis/migration-documentation/notice.html
+++ b/content/components/artemis/migration-documentation/message-store.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Legal Notice · ActiveMQ Artemis Documentation</title>
+ <title>Message Store · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,6 +57,8 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+ <link rel="next" href="notice.html" />
+
<link rel="prev" href="ssl.html" />
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter active" data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Legal Notice</a>
+ <a href="." >Message Store</a>
</h1>
</div>
@@ -236,19 +290,12 @@
<section class="normal markdown-section">
- <h1 id="legal-notice">Legal Notice</h1>
-<p>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</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">http://www.apache.org/licenses/LICENSE-2.0</a></p>
-<p>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.</p>
+ <h1 id="message-store-migration">Message Store Migration</h1>
+<h2 id="activemq-5-kahadb-or-mkahadb">ActiveMQ 5 KahaDB or mKahaDB</h2>
+<p>ActiveMQ Artemis supports an XML format for message store exchange. An existing store may be exported from a broker using the command line tools and subsequently imported to another broker.</p>
+<p>The <a href="https://github.com/apache/activemq-cli-tools" target="_blank">Apache ActiveMQ Command Line Tools</a> project provides an command line export tool for ActiveMQ 5.x that will export a KahaDB (or mKahaDB) message store into the ActiveMQ Artemis XML format, for subsequent import by ActiveMQ Artemis.</p>
+<p>The export tool supports selective export using filters, useful if only some of your data needs to be migrated. From version 0.2.0, the export tool has support for virtual topic consumer queue mapping, which will allow existing Openwire virtual topic consumers to resume on an ActiveMQ Artemis broker with no message loss. Note the OpenWire acceptor <code>virtualTopicConsumerWildcards</code> option from <a href="VirtualTopics.html">virtual topics migration</a>.</p>
+<p>Full details of tool can be found on the project website: <a href="https://github.com/apache/activemq-cli-tools" target="_blank">https://github.com/apache/activemq-cli-tools</a></p>
</section>
@@ -276,11 +323,15 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="ssl.html" class="navigation navigation-prev " aria-label="Previous page: SSL">
<i class="fa fa-angle-left"></i>
</a>
+ <a href="notice.html" class="navigation navigation-next " aria-label="Next page: Legal Notice">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
</div>
@@ -288,7 +339,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Message Store","level":"1.11","depth":1,"next":{"title":"Legal Notice","level":"1.12","depth":1,"path":"notice.md","ref":"notice.md","articles":[]},"previous":{"title":"SSL","level":"1.10","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/ [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/notice.html b/content/components/artemis/migration-documentation/notice.html
index 5cd6784..1dd7d3a 100644
--- a/content/components/artemis/migration-documentation/notice.html
+++ b/content/components/artemis/migration-documentation/notice.html
@@ -7,7 +7,7 @@
<title>Legal Notice · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -58,7 +58,7 @@
- <link rel="prev" href="ssl.html" />
+ <link rel="prev" href="message-store.html" />
</head>
@@ -100,7 +100,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +139,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +152,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +165,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +191,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +204,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +217,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -276,7 +328,7 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="message-store.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: Message Store">
<i class="fa fa-angle-left"></i>
</a>
@@ -288,7 +340,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.12","depth":1,"previous":{"title":"Message Store","level":"1.11","depth":1,"path":"message-store.md","ref":"message-store.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize": [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/notice.html b/content/components/artemis/migration-documentation/preface.html
similarity index 53%
copy from src/components/artemis/migration-documentation/notice.html
copy to content/components/artemis/migration-documentation/preface.html
index 5cd6784..f572344 100644
--- a/src/components/artemis/migration-documentation/notice.html
+++ b/content/components/artemis/migration-documentation/preface.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Legal Notice · ActiveMQ Artemis Documentation</title>
+ <title>Preface · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,8 +57,10 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+ <link rel="next" href="key-differences.html" />
- <link rel="prev" href="ssl.html" />
+
+ <link rel="prev" href="./" />
</head>
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter active" data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Legal Notice</a>
+ <a href="." >Preface</a>
</h1>
</div>
@@ -236,19 +290,11 @@
<section class="normal markdown-section">
- <h1 id="legal-notice">Legal Notice</h1>
-<p>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</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">http://www.apache.org/licenses/LICENSE-2.0</a></p>
-<p>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.</p>
+ <h1 id="preface">Preface</h1>
+<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
+<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact.</p>
+<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
+<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
</section>
@@ -276,11 +322,15 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="./" class="navigation navigation-prev " aria-label="Previous page: Introduction">
<i class="fa fa-angle-left"></i>
</a>
+ <a href="key-differences.html" class="navigation navigation-next " aria-label="Next page: Key Differences">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
</div>
@@ -288,7 +338,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Preface","level":"1.2","depth":1,"next":{"title":"Key Differences","level":"1.3","depth":1,"path":"key-differences.md","ref":"key-differences.md","articles":[]},"previous":{"title":"Introduction","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/search_index.json b/content/components/artemis/migration-documentation/search_index.json
index 40a219d..fab38e7 100644
--- a/content/components/artemis/migration-documentation/search_index.json
+++ b/content/components/artemis/migration-documentation/search_index.json
@@ -1 +1 @@
-{"index":{"version":"0.5.12","fields":[{"name":"title","boost":10},{"name":"keywords","boost":15},{"name":"body","boost":1}],"ref":"url","documentStore":{"store":{"./":["(and","(befor","(non","(queues)","(synchron","(topics)","5.x","achiev","activemq","activemq,","ad","adapt","address","address.","addresses.","advis","affect","again","again,","aim","although","amqp","anoth","anycast","apach","append","approach.","appropri","architectur","arrived.","artemi","artemis,","artemis.","articles [...]
\ No newline at end of file
+{"index":{"version":"0.5.12","fields":[{"name":"title","boost":10},{"name":"keywords","boost":15},{"name":"body","boost":1}],"ref":"url","documentStore":{"store":{"./":["5","activemq","apach","artemi","artemis.","broker","exist","guid","instal","introduct","migrat","outlin","user"],"preface.html":["5.x","activemq","adapt","advis","aim","appropri","artemi","artemis,","artemis.","articles.","assum","basic","befor","between","broad","broker","broker.","brokers.","client","clients.","concept [...]
\ No newline at end of file
diff --git a/content/components/artemis/migration-documentation/ssl.html b/content/components/artemis/migration-documentation/ssl.html
index 36fd8c7..1690365 100644
--- a/content/components/artemis/migration-documentation/ssl.html
+++ b/content/components/artemis/migration-documentation/ssl.html
@@ -7,7 +7,7 @@
<title>SSL · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="notice.html" />
+ <link rel="next" href="message-store.html" />
<link rel="prev" href="authorization.html" />
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter active" data-level="1.7" data-path="ssl.html">
+ <li class="chapter active" data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -317,7 +369,7 @@
</a>
- <a href="notice.html" class="navigation navigation-next " aria-label="Next page: Legal Notice">
+ <a href="message-store.html" class="navigation navigation-next " aria-label="Next page: Message Store">
<i class="fa fa-angle-right"></i>
</a>
@@ -328,7 +380,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"SSL","level":"1.7","depth":1,"next":{"title":"Legal Notice","level":"1.8","depth":1,"path":"notice.md","ref":"notice.md","articles":[]},"previous":{"title":"Authorization","level":"1.6","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css" [...]
+ gitbook.page.hasChanged({"page":{"title":"SSL","level":"1.10","depth":1,"next":{"title":"Message Store","level":"1.11","depth":1,"path":"message-store.md","ref":"message-store.md","articles":[]},"previous":{"title":"Authorization","level":"1.9","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":" [...]
});
</script>
</div>
diff --git a/src/components/artemis/index.html b/src/components/artemis/index.html
index 92bd75b..517648a 100644
--- a/src/components/artemis/index.html
+++ b/src/components/artemis/index.html
@@ -9,7 +9,6 @@ project_class: artemis
<div class="row project-narative">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple">
@@ -25,11 +24,6 @@ project_class: artemis
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="{{site.baseurl}}/assets/img/example-diagram.png"/>
- </div>
- </div-->
</div>
</div>
</div>
@@ -41,7 +35,6 @@ project_class: artemis
<div class="row project-narative-alt">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple project-narative-alt">
@@ -57,11 +50,6 @@ project_class: artemis
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="{{site.baseurl}}/assets/img/example-diagram.png"/>
- </div>
- </div-->
</div>
</div>
</div>
@@ -73,7 +61,6 @@ project_class: artemis
<div class="row project-narative">
<div class="col-12">
<div class="container">
- <!-- Narative 2 -->
<div class="row">
<div class="col-12">
<div class="card card-purple">
@@ -89,11 +76,6 @@ project_class: artemis
</div>
</div>
</div>
- <!--div class="col-sm-12 col-md-6 parent d-none d-md-block">
- <div class="child align-center" style="text-align: center">
- <img class="align-center" style="width: 60%; margin: auto" src="{{site.baseurl}}/assets/img/example-diagram.png"/>
- </div>
- </div-->
</div>
</div>
</div>
@@ -102,3 +84,29 @@ project_class: artemis
</div>
</div>
</div>
+<div class="row project-narative-alt">
+ <div class="col-12">
+ <div class="container">
+ <div class="row">
+ <div class="col-12">
+ <div class="card card-purple project-narative-alt">
+ <div class="card-body">
+ <div class="row">
+ <div class="col-sm-12 col-md-8">
+ <div class="card">
+ <div class="card-body project-narative-alt">
+ <h5 class="card-title text-purple">Guide for Migration to ActiveMQ Artemis</h5>
+ <h6>Easily migrate from ActiveMQ 5</h6>
+ <p>ActiveMQ Artemis has analogues to all of the ActiveMQ 5 core features and full support for the ActiveMQ 5 OpenWire protocol.</p>
+ <a style="margin-top: 10px" href="migration" class="btn btn-warning">Find out more<i class="fa-info-circle fa btn-icon"></i></a>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+</div>
\ No newline at end of file
diff --git a/src/components/artemis/migration-documentation/VirtualTopics.html b/src/components/artemis/migration-documentation/VirtualTopics.html
new file mode 100644
index 0000000..24126d7
--- /dev/null
+++ b/src/components/artemis/migration-documentation/VirtualTopics.html
@@ -0,0 +1,413 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+ <head>
+ <meta charset="UTF-8">
+ <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+ <title>Virtual Topics · ActiveMQ Artemis Documentation</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+ <meta name="description" content="">
+ <meta name="generator" content="GitBook 3.2.3">
+
+
+
+
+ <link rel="stylesheet" href="gitbook/style.css">
+
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+
+
+
+ <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <meta name="HandheldFriendly" content="true"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black">
+ <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+ <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+
+ <link rel="next" href="authentication.html" />
+
+
+ <link rel="prev" href="destinations.html" />
+
+
+ </head>
+ <body>
+
+<div class="book">
+ <div class="book-summary">
+
+
+<div id="book-search-input" role="search">
+ <input type="text" placeholder="Type to search" />
+</div>
+
+
+ <nav role="navigation">
+
+
+
+<ul class="summary">
+
+
+
+
+
+
+
+
+
+ <li class="chapter " data-level="1.1" data-path="./">
+
+ <a href="./">
+
+
+ Introduction
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
+
+ <a href="configuration.html">
+
+
+ Configuration
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
+
+ <a href="connectors.html">
+
+
+ Connectors
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
+
+ <a href="destinations.html">
+
+
+ Destinations
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
+
+ <a href="authentication.html">
+
+
+ Authentication
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
+
+ <a href="authorization.html">
+
+
+ Authorization
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
+
+ <a href="ssl.html">
+
+
+ SSL
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
+
+ <a href="notice.html">
+
+
+ Legal Notice
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="divider"></li>
+
+ <li>
+ <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+ Published with GitBook
+ </a>
+ </li>
+</ul>
+
+
+ </nav>
+
+
+ </div>
+
+ <div class="book-body">
+
+ <div class="body-inner">
+
+
+
+<div class="book-header" role="navigation">
+
+
+ <!-- Title -->
+ <h1>
+ <i class="fa fa-circle-o-notch fa-spin"></i>
+ <a href="." >Virtual Topics</a>
+ </h1>
+</div>
+
+
+
+
+ <div class="page-wrapper" tabindex="-1" role="main">
+ <div class="page-inner">
+
+<div id="book-search-results">
+ <div class="search-noresults">
+
+ <section class="normal markdown-section">
+
+ <h1 id="virtual-topics">Virtual Topics</h1>
+<p>Virtual Topics (a specialisation of virtual destinations) in ActiveMQ 5.x typically address two different but related
+problems. Lets take each in turn:</p>
+<h2 id="shared-access-to-a-jms-durable-topic-subscription">Shared access to a JMS durable topic subscription</h2>
+<p>With JMS1.1, a durable subscription is identified by the pair of clientId and subscriptionName. The clientId
+component must be unique to a connection on the broker. This means that the subscription is exclusive. It is
+not possible to load balance the stream of messages across consumers and quick failover is difficult because the
+existing connection state on the broker needs to be first disposed.
+With virtual topics, each subscription's stream of messages is redirected to a queue.</p>
+<p>In Artemis there are two alternatives, the new JMS 2.0 api or direct access to a subscription queue via the FQQN.</p>
+<h2 id="jms-20-shared-subscriptions">JMS 2.0 shared subscriptions</h2>
+<p>JMS 2.0 adds the possibility of shared subscriptions with new API's that are fully supported in Artemis.</p>
+<h2 id="fully-qualified-queue-name-fqqn">Fully Qualified Queue name (FQQN)</h2>
+<p>Secondly, Artemis uses a queue per topic subscriber model internally and it is possibly to directly address the
+subscription queue using its Fully Qualified Queue name (FQQN).</p>
+<p>For example, a default 5.x consumer destination for topic <code>VirtualTopic.Orders</code> subscription <code>A</code>:</p>
+<pre><code> ...
+ Queue subscriptionQueue = session.createQueue("Consumer.A.VirtualTopic.Orders");
+ session.createConsumer(subscriptionQueue);
+</code></pre><p>would be replaced with an Artemis FQQN comprised of the address and queue.</p>
+<pre><code> ...
+ Queue subscriptionQueue = session.createQueue("VirtualTopic.Orders::Consumer.A.VirtualTopic.Orders");
+ session.createConsumer(subscriptionQueue);
+</code></pre><p>This does require modification to the destination name used by consumers which is not ideal.
+If OpenWire clients cannot be modified, Artemis supports a virtual topic wildcard filter
+mechanism on the OpenWire protocol handler that will automatically convert the consumer destination into the
+corresponding FQQN.
+The format is a comma separated list of strings pairs, delimited with a ';'. Each pair identifies a filter to match
+the virtual topic consumer destination and an int that specifies the number of path matches that terminate the consumer
+queue identity.</p>
+<p>E.g: For the default 5.x virtual topic consumer prefix of <code>Consumer.*.</code> the parameter <code>virtualTopicConsumerWildcards</code> should be: <code>Consumer.*.>;2</code>.
+However, there is a caveat because this value needs to be encoded in a uri for the xml configuration. Any unsafe url characters
+, in this case: <code>> ;</code> need to be escaped with their hex code point representation; leading to a value of <code>Consumer.*.%3E%3B2</code>.
+In this way a consumer destination of <code>Consumer.A.VirtualTopic.Orders</code> will be transformed into a FQQN of
+<code>VirtualTopic.Orders::Consumer.A.VirtualTopic.Orders</code>.</p>
+<h2 id="durable-topic-subscribers-in-a-network-of-brokers">Durable topic subscribers in a network of brokers</h2>
+<p>The store and forward network bridges in 5.x create a durable subscriber per destination. As demand migrates across a
+network, duplicate durable subs get created on each node in the network but they do not migrate. The end result can
+result in duplicate message storage and ultimately duplicate delivery, which is not good.
+When durable subscribers map to virtual topic subscriber queues, the queues can migrate and the problem can be avoided.</p>
+<p>In Artemis, because a durable sub is modeled as a queue, this problem does not arise.</p>
+
+
+ </section>
+
+ </div>
+ <div class="search-results">
+ <div class="has-results">
+
+ <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+ <ul class="search-results-list"></ul>
+
+ </div>
+ <div class="no-results">
+
+ <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+
+ </div>
+ </div>
+</div>
+
+ </div>
+ </div>
+
+ </div>
+
+
+
+ <a href="destinations.html" class="navigation navigation-prev " aria-label="Previous page: Destinations">
+ <i class="fa fa-angle-left"></i>
+ </a>
+
+
+ <a href="authentication.html" class="navigation navigation-next " aria-label="Next page: Authentication">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
+
+
+ </div>
+
+ <script>
+ var gitbook = gitbook || [];
+ gitbook.push(function() {
+ gitbook.page.hasChanged({"page":{"title":"Virtual Topics","level":"1.7","depth":1,"next":{"title":"Authentication","level":"1.8","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"previous":{"title":"Destinations","level":"1.6","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css", [...]
+ });
+ </script>
+</div>
+
+
+ <script src="gitbook/gitbook.js"></script>
+ <script src="gitbook/theme.js"></script>
+
+
+ <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-search/search.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+
+
+
+ <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+
+
+
+ </body>
+</html>
+
diff --git a/src/components/artemis/migration-documentation/authentication.html b/src/components/artemis/migration-documentation/authentication.html
index 4647243..0fe0142 100644
--- a/src/components/artemis/migration-documentation/authentication.html
+++ b/src/components/artemis/migration-documentation/authentication.html
@@ -7,7 +7,7 @@
<title>Authentication · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,7 +60,7 @@
<link rel="next" href="authorization.html" />
- <link rel="prev" href="destinations.html" />
+ <link rel="prev" href="VirtualTopics.html" />
</head>
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter active" data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -279,7 +331,7 @@
- <a href="destinations.html" class="navigation navigation-prev " aria-label="Previous page: Destinations">
+ <a href="VirtualTopics.html" class="navigation navigation-prev " aria-label="Previous page: Virtual Topics">
<i class="fa fa-angle-left"></i>
</a>
@@ -295,7 +347,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Authentication","level":"1.5","depth":1,"next":{"title":"Authorization","level":"1.6","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"previous":{"title":"Destinations","level":"1.4","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","eb [...]
+ gitbook.page.hasChanged({"page":{"title":"Authentication","level":"1.8","depth":1,"next":{"title":"Authorization","level":"1.9","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"previous":{"title":"Virtual Topics","level":"1.7","depth":1,"path":"VirtualTopics.md","ref":"VirtualTopics.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css" [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/authorization.html b/src/components/artemis/migration-documentation/authorization.html
index b0c0b53..88730b3 100644
--- a/src/components/artemis/migration-documentation/authorization.html
+++ b/src/components/artemis/migration-documentation/authorization.html
@@ -7,7 +7,7 @@
<title>Authorization · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter active" data-level="1.6" data-path="authorization.html">
+ <li class="chapter active" data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -428,7 +480,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Authorization","level":"1.6","depth":1,"next":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"previous":{"title":"Authentication","level":"1.5","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css"," [...]
+ gitbook.page.hasChanged({"page":{"title":"Authorization","level":"1.9","depth":1,"next":{"title":"SSL","level":"1.10","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"previous":{"title":"Authentication","level":"1.8","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css", [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/configuration.html b/src/components/artemis/migration-documentation/configuration.html
index 9d7ad67..c625d48 100644
--- a/src/components/artemis/migration-documentation/configuration.html
+++ b/src/components/artemis/migration-documentation/configuration.html
@@ -7,7 +7,7 @@
<title>Configuration · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,7 +60,7 @@
<link rel="next" href="connectors.html" />
- <link rel="prev" href="./" />
+ <link rel="prev" href="key-differences.html" />
</head>
@@ -102,7 +102,33 @@
</li>
- <li class="chapter active" data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -253,7 +305,7 @@
<p>Let's take a look now at the configuration in more details. The entry <code>etc/bootstrap.xml</code> file is here to set the basics, like the location of the main broker configuration file, utility apps like a web server and JAAS security.</p>
<p>The main configuration file is <code>etc/broker.xml</code>. Similarly to ActiveMQ's <code>conf/activemq.xml</code>, this is where you configure most of the aspects of the broker, like connector ports, destination names, security policies, etc. We will go through this file in details in the following articles.</p>
<p>The <code>etc/artemis.profile</code> file is similar to the <code>bin/env</code> file in ActiveMQ. Here you can configure environment variables for the broker, mostly regular JVM args related to SSL context, debugging, etc.</p>
-<p>There's no much difference in logging configuration between two brokers, so anyone familiar with Java logging systems in general will find herself at home here. The <code>etc/logging.properties</code> file is where it's all configured.</p>
+<p>There's not much difference in logging configuration between two brokers, so anyone familiar with Java logging systems in general will find herself at home here. The <code>etc/logging.properties</code> file is where it's all configured.</p>
<p>Finally, we have JAAS configuration files (<code>login.config</code>, <code>artemis-users.properties</code> and <code>artemis-roles.properties</code>), which cover same roles as in ActiveMQ and we will go into more details on these in the article that covers security.</p>
<p>After this brief walk through the location of different configuration aspects of Artemis, we're ready to start the broker. If you wish to start the broker in the foreground, you should execute</p>
<pre><code class="lang-sh">$ bin/artemis run
@@ -304,7 +356,7 @@ $ bin/activemq consumer
- <a href="./" class="navigation navigation-prev " aria-label="Previous page: Introduction">
+ <a href="key-differences.html" class="navigation navigation-prev " aria-label="Previous page: Key Differences">
<i class="fa fa-angle-left"></i>
</a>
@@ -320,7 +372,7 @@ $ bin/activemq consumer
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Configuration","level":"1.2","depth":1,"next":{"title":"Connectors","level":"1.3","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"previous":{"title":"Introduction","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css [...]
+ gitbook.page.hasChanged({"page":{"title":"Configuration","level":"1.4","depth":1,"next":{"title":"Connectors","level":"1.5","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"previous":{"title":"Key Differences","level":"1.3","depth":1,"path":"key-differences.md","ref":"key-differences.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebo [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/connectors.html b/src/components/artemis/migration-documentation/connectors.html
index 5c46cec..6a36def 100644
--- a/src/components/artemis/migration-documentation/connectors.html
+++ b/src/components/artemis/migration-documentation/connectors.html
@@ -7,7 +7,7 @@
<title>Connectors · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter active" data-level="1.3" data-path="connectors.html">
+ <li class="chapter active" data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -346,7 +398,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Connectors","level":"1.3","depth":1,"next":{"title":"Destinations","level":"1.4","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"previous":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook" [...]
+ gitbook.page.hasChanged({"page":{"title":"Connectors","level":"1.5","depth":1,"next":{"title":"Destinations","level":"1.6","depth":1,"path":"destinations.md","ref":"destinations.md","articles":[]},"previous":{"title":"Configuration","level":"1.4","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook" [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/destinations.html b/src/components/artemis/migration-documentation/destinations.html
index 62222de..df1926b 100644
--- a/src/components/artemis/migration-documentation/destinations.html
+++ b/src/components/artemis/migration-documentation/destinations.html
@@ -7,7 +7,7 @@
<title>Destinations · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="authentication.html" />
+ <link rel="next" href="VirtualTopics.html" />
<link rel="prev" href="connectors.html" />
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter active" data-level="1.4" data-path="destinations.html">
+ <li class="chapter active" data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -293,7 +345,7 @@
</a>
- <a href="authentication.html" class="navigation navigation-next " aria-label="Next page: Authentication">
+ <a href="VirtualTopics.html" class="navigation navigation-next " aria-label="Next page: Virtual Topics">
<i class="fa fa-angle-right"></i>
</a>
@@ -304,7 +356,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Destinations","level":"1.4","depth":1,"next":{"title":"Authentication","level":"1.5","depth":1,"path":"authentication.md","ref":"authentication.md","articles":[]},"previous":{"title":"Connectors","level":"1.3","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook": [...]
+ gitbook.page.hasChanged({"page":{"title":"Destinations","level":"1.6","depth":1,"next":{"title":"Virtual Topics","level":"1.7","depth":1,"path":"VirtualTopics.md","ref":"VirtualTopics.md","articles":[]},"previous":{"title":"Connectors","level":"1.5","depth":1,"path":"connectors.md","ref":"connectors.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"s [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/gitbook/gitbook.js b/src/components/artemis/migration-documentation/gitbook/gitbook.js
index 10000c7..13077b4 100644
--- a/src/components/artemis/migration-documentation/gitbook/gitbook.js
+++ b/src/components/artemis/migration-documentation/gitbook/gitbook.js
@@ -1,4 +1,4 @@
!function e(t,n,r){function o(s,a){if(!n[s]){if(!t[s]){var u="function"==typeof require&&require;if(!a&&u)return u(s,!0);if(i)return i(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var l=n[s]={exports:{}};t[s][0].call(l.exports,function(e){var n=t[s][1][e];return o(n?n:e)},l,l.exports,e,t,n,r)}return n[s].exports}for(var i="function"==typeof require&&require,s=0;s<r.length;s++)o(r[s]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"objec [...]
return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(xe,be),function(t){return(t.textContent||t.innerText||j(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(xe,be).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.h [...]
-var o=de.isEmptyObject(e),i=de.speed(t,n,r),s=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,o||i.queue===!1?this.each(s):this.queue(i.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,s=Fe.get(this);if(o)s[o]&&s[o].stop&&r(s[o]);else for(o in s)s[o]&&s[o].st [...]
-o}function i(e){return c.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function s(e,t){return o(e,!1,!0).resolve(t)}function a(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),c=e("./util");n.parse=o,n.resolve=s,n.resolveObject=a,n.format=i,n.Url=r;var l=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=["{","}","|","\\","^","`"].concat(h),g=["'"].concat(d),m=["%","/","?",";","#"].c [...]
+var o=de.isEmptyObject(e),i=de.speed(t,n,r),s=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,o||i.queue===!1?this.each(s):this.queue(i.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,s=Fe.get(this);if(o)s[o]&&s[o].stop&&r(s[o]);else for(o in s)s[o]&&s[o].st [...]
+if(e&&c.isObject(e)&&e instanceof r)return e;var o=new r;return o.parse(e,t,n),o}function i(e){return c.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function s(e,t){return o(e,!1,!0).resolve(t)}function a(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),c=e("./util");n.parse=o,n.resolve=s,n.resolveObject=a,n.format=i,n.Url=r;var l=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=[ [...]
diff --git a/src/components/artemis/migration-documentation/gitbook/theme.js b/src/components/artemis/migration-documentation/gitbook/theme.js
index 4c22928..268002a 100644
--- a/src/components/artemis/migration-documentation/gitbook/theme.js
+++ b/src/components/artemis/migration-documentation/gitbook/theme.js
@@ -1,4 +1,4 @@
!function e(t,n,r){function o(a,s){if(!n[a]){if(!t[a]){var u="function"==typeof require&&require;if(!s&&u)return u(a,!0);if(i)return i(a,!0);var l=new Error("Cannot find module '"+a+"'");throw l.code="MODULE_NOT_FOUND",l}var c=n[a]={exports:{}};t[a][0].call(c.exports,function(e){var n=t[a][1][e];return o(n?n:e)},c,c.exports,e,t,n,r)}return n[a].exports}for(var i="function"==typeof require&&require,a=0;a<r.length;a++)o(r[a]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"objec [...]
return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(be,xe),function(t){return(t.textContent||t.innerText||k(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(be,xe).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.h [...]
var o=de.isEmptyObject(e),i=de.speed(t,n,r),a=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return a.finish=a,o||i.queue===!1?this.each(a):this.queue(i.queue,a)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,a=Fe.get(this);if(o)a[o]&&a[o].stop&&r(a[o]);else for(o in a)a[o]&&a[o].st [...]
-r(a,h)?o(a[h])?a[h].push(d):a[h]=[a[h],d]:a[h]=d}return a};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],5:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,s){return t=t||"&",n=n||"=" [...]
+r(a,h)?o(a[h])?a[h].push(d):a[h]=[a[h],d]:a[h]=d}return a};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],5:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,s){return t=t||"&",n=n||"=" [...]
diff --git a/src/components/artemis/migration-documentation/images/artemis-logo.png b/src/components/artemis/migration-documentation/images/artemis-logo.png
new file mode 100644
index 0000000..de602ee
Binary files /dev/null and b/src/components/artemis/migration-documentation/images/artemis-logo.png differ
diff --git a/src/components/artemis/migration-documentation/index.html b/src/components/artemis/migration-documentation/index.html
index d73a17f..d636630 100644
--- a/src/components/artemis/migration-documentation/index.html
+++ b/src/components/artemis/migration-documentation/index.html
@@ -7,7 +7,7 @@
<title>Introduction · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="configuration.html" />
+ <link rel="next" href="preface.html" />
@@ -100,7 +100,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +139,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +152,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +165,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +191,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +204,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +217,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -236,23 +288,9 @@
<section class="normal markdown-section">
- <p><img src="images/artemis-logo.jpg" alt="ActiveMQ Artemis logo"></p>
+ <p><img src="images/artemis-logo.png" alt="ActiveMQ Artemis logo"></p>
<h1 id="apache-activemq-artemis-migration-guide">Apache ActiveMQ Artemis Migration Guide</h1>
-<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
-<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact. This guide will not cover a message store migration. That topic and aspects of migrating clients that use some other protocol will be the subject of [...]
-<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
-<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
-<h2 id="architectural-differences">Architectural differences</h2>
-<p>Although they are designed to do the same job, things are done differently internally. Here are some of the most notable architectural differences you need to be aware of when you're planning the migration.</p>
-<p>In ActiveMQ, we have a few different implementations of the IO connectivity layer, like tcp (synchronous one) and nio (non-blocking one). In Artemis, the IO layer is implemented using Netty, which is a nio framework. This means that there's no more need to choose between different implementations as the non-blocking one is used by default.</p>
-<p>The other important part of every broker is a message store. Most of the ActiveMQ users are familiar with KahaDB. It consists of a message journal for fast sequential storing of messages (and other command packets) and an index for retrieving messages when needed.</p>
-<p>Artemis has its own message store. It consists only of the append-only message journal. Because of the differences in how paging is done, there's no need for the message index. We'll talk more about that in a minute. It's important to say at this point that these two stores are not interchangeable, and data migration if needed must be carefully planed.</p>
-<p>What do we mean by paging differences? Paging is the process that happens when broker can't hold all incoming messages in its memory. The strategy of how to deal with this situation differs between two brokers. ActiveMQ have <em>cursors</em>, which are basically a cache of messages ready to be dispatched to the consumer. It will try to keep all incoming messages in there. When we run out of the the available memory, messages are added to the store, but the caching stops. When the [...]
-<p>In Artemis, things work differently in this regard. The whole message journal is kept in memory and messages are dispatched directly from it. When we run out of memory, messages are paged <em>on the producer side</em> (before they hit the broker). Theay are stored in sequential page files in the same order as they arrived. Once the memory is freed, messages are moved from these page files into the journal. With paging working like this, messages are read from the file journal only whe [...]
-<p>This is one of the main differences between ActiveMQ 5.x and Artemis. It's important to understand it early on as it affects a lot of destination policy settings and how we configure brokers in order to support these scenarios properly. </p>
-<h2 id="addressing-differences">Addressing differences</h2>
-<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as a open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP ar [...]
-<p>Artemis took a different approach. It implements only queues internally and all other messaging concepts are achieved by routing messages to appropriate queue(s) using addresses. Messaging concepts like publish-subscribe (topics) and point-to-point (queues) are implemented using different type of routing mechanisms on addresses. <em>Multicast</em> routing is used to implement <em>publish-subscribe</em> semantics, where all subscribers to a certain address will get their own internal q [...]
+<p>The migration guide outlines how users can migrate an existing ActiveMQ 5 broker installation to ActiveMQ Artemis.</p>
</section>
@@ -281,7 +319,7 @@
- <a href="configuration.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Configuration">
+ <a href="preface.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Preface">
<i class="fa fa-angle-right"></i>
</a>
@@ -292,7 +330,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":100000 [...]
+ gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Preface","level":"1.2","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCh [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/index.html b/src/components/artemis/migration-documentation/key-differences.html
similarity index 69%
copy from content/components/artemis/migration-documentation/index.html
copy to src/components/artemis/migration-documentation/key-differences.html
index d73a17f..ef76996 100644
--- a/content/components/artemis/migration-documentation/index.html
+++ b/src/components/artemis/migration-documentation/key-differences.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Introduction · ActiveMQ Artemis Documentation</title>
+ <title>Key Differences · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -60,6 +60,8 @@
<link rel="next" href="configuration.html" />
+ <link rel="prev" href="preface.html" />
+
</head>
<body>
@@ -87,7 +89,7 @@
- <li class="chapter active" data-level="1.1" data-path="./">
+ <li class="chapter " data-level="1.1" data-path="./">
<a href="./">
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Introduction</a>
+ <a href="." >Key Differences</a>
</h1>
</div>
@@ -236,12 +290,7 @@
<section class="normal markdown-section">
- <p><img src="images/artemis-logo.jpg" alt="ActiveMQ Artemis logo"></p>
-<h1 id="apache-activemq-artemis-migration-guide">Apache ActiveMQ Artemis Migration Guide</h1>
-<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
-<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact. This guide will not cover a message store migration. That topic and aspects of migrating clients that use some other protocol will be the subject of [...]
-<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
-<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
+ <h1 id="differences-from-activemq-5">Differences From ActiveMQ 5</h1>
<h2 id="architectural-differences">Architectural differences</h2>
<p>Although they are designed to do the same job, things are done differently internally. Here are some of the most notable architectural differences you need to be aware of when you're planning the migration.</p>
<p>In ActiveMQ, we have a few different implementations of the IO connectivity layer, like tcp (synchronous one) and nio (non-blocking one). In Artemis, the IO layer is implemented using Netty, which is a nio framework. This means that there's no more need to choose between different implementations as the non-blocking one is used by default.</p>
@@ -251,7 +300,7 @@
<p>In Artemis, things work differently in this regard. The whole message journal is kept in memory and messages are dispatched directly from it. When we run out of memory, messages are paged <em>on the producer side</em> (before they hit the broker). Theay are stored in sequential page files in the same order as they arrived. Once the memory is freed, messages are moved from these page files into the journal. With paging working like this, messages are read from the file journal only whe [...]
<p>This is one of the main differences between ActiveMQ 5.x and Artemis. It's important to understand it early on as it affects a lot of destination policy settings and how we configure brokers in order to support these scenarios properly. </p>
<h2 id="addressing-differences">Addressing differences</h2>
-<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as a open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP ar [...]
+<p>Another big difference that's good to cover early on is the difference is how message addressing and routing is done. ActiveMQ started as an open source JMS implementation, so at its core all JMS concepts like queues, topics and durable subscriptions are implemented as the first-class citizens. It's all based on OpenWire protocol developed within the project and even KahaDB message store is OpenWire centric. This means that all other supported protocols, like MQTT and AMQP a [...]
<p>Artemis took a different approach. It implements only queues internally and all other messaging concepts are achieved by routing messages to appropriate queue(s) using addresses. Messaging concepts like publish-subscribe (topics) and point-to-point (queues) are implemented using different type of routing mechanisms on addresses. <em>Multicast</em> routing is used to implement <em>publish-subscribe</em> semantics, where all subscribers to a certain address will get their own internal q [...]
@@ -280,8 +329,12 @@
+ <a href="preface.html" class="navigation navigation-prev " aria-label="Previous page: Preface">
+ <i class="fa fa-angle-left"></i>
+ </a>
+
- <a href="configuration.html" class="navigation navigation-next navigation-unique" aria-label="Next page: Configuration">
+ <a href="configuration.html" class="navigation navigation-next " aria-label="Next page: Configuration">
<i class="fa fa-angle-right"></i>
</a>
@@ -292,7 +345,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Introduction","level":"1.1","depth":1,"next":{"title":"Configuration","level":"1.2","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":100000 [...]
+ gitbook.page.hasChanged({"page":{"title":"Key Differences","level":"1.3","depth":1,"next":{"title":"Configuration","level":"1.4","depth":1,"path":"configuration.md","ref":"configuration.md","articles":[]},"previous":{"title":"Preface","level":"1.2","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/e [...]
});
</script>
</div>
diff --git a/content/components/artemis/migration-documentation/notice.html b/src/components/artemis/migration-documentation/message-store.html
similarity index 53%
copy from content/components/artemis/migration-documentation/notice.html
copy to src/components/artemis/migration-documentation/message-store.html
index 5cd6784..c1a21cf 100644
--- a/content/components/artemis/migration-documentation/notice.html
+++ b/src/components/artemis/migration-documentation/message-store.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Legal Notice · ActiveMQ Artemis Documentation</title>
+ <title>Message Store · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,6 +57,8 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+ <link rel="next" href="notice.html" />
+
<link rel="prev" href="ssl.html" />
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter active" data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Legal Notice</a>
+ <a href="." >Message Store</a>
</h1>
</div>
@@ -236,19 +290,12 @@
<section class="normal markdown-section">
- <h1 id="legal-notice">Legal Notice</h1>
-<p>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</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">http://www.apache.org/licenses/LICENSE-2.0</a></p>
-<p>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.</p>
+ <h1 id="message-store-migration">Message Store Migration</h1>
+<h2 id="activemq-5-kahadb-or-mkahadb">ActiveMQ 5 KahaDB or mKahaDB</h2>
+<p>ActiveMQ Artemis supports an XML format for message store exchange. An existing store may be exported from a broker using the command line tools and subsequently imported to another broker.</p>
+<p>The <a href="https://github.com/apache/activemq-cli-tools" target="_blank">Apache ActiveMQ Command Line Tools</a> project provides an command line export tool for ActiveMQ 5.x that will export a KahaDB (or mKahaDB) message store into the ActiveMQ Artemis XML format, for subsequent import by ActiveMQ Artemis.</p>
+<p>The export tool supports selective export using filters, useful if only some of your data needs to be migrated. From version 0.2.0, the export tool has support for virtual topic consumer queue mapping, which will allow existing Openwire virtual topic consumers to resume on an ActiveMQ Artemis broker with no message loss. Note the OpenWire acceptor <code>virtualTopicConsumerWildcards</code> option from <a href="VirtualTopics.html">virtual topics migration</a>.</p>
+<p>Full details of tool can be found on the project website: <a href="https://github.com/apache/activemq-cli-tools" target="_blank">https://github.com/apache/activemq-cli-tools</a></p>
</section>
@@ -276,11 +323,15 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="ssl.html" class="navigation navigation-prev " aria-label="Previous page: SSL">
<i class="fa fa-angle-left"></i>
</a>
+ <a href="notice.html" class="navigation navigation-next " aria-label="Next page: Legal Notice">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
</div>
@@ -288,7 +339,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Message Store","level":"1.11","depth":1,"next":{"title":"Legal Notice","level":"1.12","depth":1,"path":"notice.md","ref":"notice.md","articles":[]},"previous":{"title":"SSL","level":"1.10","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/ [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/notice.html b/src/components/artemis/migration-documentation/notice.html
index 5cd6784..1dd7d3a 100644
--- a/src/components/artemis/migration-documentation/notice.html
+++ b/src/components/artemis/migration-documentation/notice.html
@@ -7,7 +7,7 @@
<title>Legal Notice · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -58,7 +58,7 @@
- <link rel="prev" href="ssl.html" />
+ <link rel="prev" href="message-store.html" />
</head>
@@ -100,7 +100,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +139,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +152,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +165,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +191,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +204,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +217,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter active" data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -276,7 +328,7 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="message-store.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: Message Store">
<i class="fa fa-angle-left"></i>
</a>
@@ -288,7 +340,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.12","depth":1,"previous":{"title":"Message Store","level":"1.11","depth":1,"path":"message-store.md","ref":"message-store.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize": [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/notice.html b/src/components/artemis/migration-documentation/preface.html
similarity index 53%
copy from src/components/artemis/migration-documentation/notice.html
copy to src/components/artemis/migration-documentation/preface.html
index 5cd6784..f572344 100644
--- a/src/components/artemis/migration-documentation/notice.html
+++ b/src/components/artemis/migration-documentation/preface.html
@@ -4,10 +4,10 @@
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>Legal Notice · ActiveMQ Artemis Documentation</title>
+ <title>Preface · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,8 +57,10 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+ <link rel="next" href="key-differences.html" />
- <link rel="prev" href="ssl.html" />
+
+ <link rel="prev" href="./" />
</head>
@@ -100,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter active" data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -113,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -126,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -139,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -152,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -165,7 +206,7 @@
</li>
- <li class="chapter " data-level="1.7" data-path="ssl.html">
+ <li class="chapter " data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -178,7 +219,20 @@
</li>
- <li class="chapter active" data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -221,7 +275,7 @@
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
- <a href="." >Legal Notice</a>
+ <a href="." >Preface</a>
</h1>
</div>
@@ -236,19 +290,11 @@
<section class="normal markdown-section">
- <h1 id="legal-notice">Legal Notice</h1>
-<p>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</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">http://www.apache.org/licenses/LICENSE-2.0</a></p>
-<p>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.</p>
+ <h1 id="preface">Preface</h1>
+<p>As more and more people start using Artemis, it's valuable to have a migration guide that will help experienced ActiveMQ users adapt to the new broker. From outside, two brokers might seem very similar, but there are subtle differences in their inner-workings that can lead to confusions. The goal of this guide is to explain these differences and help make a transition.</p>
+<p>Migration is a fairly broad term in systems like these, so what are we talking about here? This guide will be focused only on broker server migration. We'll assume that the current system is a working ActiveMQ 5.x broker with OpenWire JMS clients. We'll see how we can replace the broker with Artemis and leave the clients intact.</p>
+<p>This guide is aimed at experienced ActiveMQ users that want to learn more about what's different in Artemis. We will assume that you know the concepts that are covered in these articles. They will not be explained from the first principles, for that you're advised to see appropriate manuals of the ActiveMQ and Artemis brokers.</p>
+<p>Before we dig into more details on the migration, let's talk about basic conceptual differences between two brokers.</p>
</section>
@@ -276,11 +322,15 @@ limitations under the License.</p>
- <a href="ssl.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: SSL">
+ <a href="./" class="navigation navigation-prev " aria-label="Previous page: Introduction">
<i class="fa fa-angle-left"></i>
</a>
+ <a href="key-differences.html" class="navigation navigation-next " aria-label="Next page: Key Differences">
+ <i class="fa fa-angle-right"></i>
+ </a>
+
</div>
@@ -288,7 +338,7 @@ limitations under the License.</p>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Legal Notice","level":"1.8","depth":1,"previous":{"title":"SSL","level":"1.7","depth":1,"path":"ssl.md","ref":"ssl.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters [...]
+ gitbook.page.hasChanged({"page":{"title":"Preface","level":"1.2","depth":1,"next":{"title":"Key Differences","level":"1.3","depth":1,"path":"key-differences.md","ref":"key-differences.md","articles":[]},"previous":{"title":"Introduction","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ [...]
});
</script>
</div>
diff --git a/src/components/artemis/migration-documentation/search_index.json b/src/components/artemis/migration-documentation/search_index.json
index 40a219d..fab38e7 100644
--- a/src/components/artemis/migration-documentation/search_index.json
+++ b/src/components/artemis/migration-documentation/search_index.json
@@ -1 +1 @@
-{"index":{"version":"0.5.12","fields":[{"name":"title","boost":10},{"name":"keywords","boost":15},{"name":"body","boost":1}],"ref":"url","documentStore":{"store":{"./":["(and","(befor","(non","(queues)","(synchron","(topics)","5.x","achiev","activemq","activemq,","ad","adapt","address","address.","addresses.","advis","affect","again","again,","aim","although","amqp","anoth","anycast","apach","append","approach.","appropri","architectur","arrived.","artemi","artemis,","artemis.","articles [...]
\ No newline at end of file
+{"index":{"version":"0.5.12","fields":[{"name":"title","boost":10},{"name":"keywords","boost":15},{"name":"body","boost":1}],"ref":"url","documentStore":{"store":{"./":["5","activemq","apach","artemi","artemis.","broker","exist","guid","instal","introduct","migrat","outlin","user"],"preface.html":["5.x","activemq","adapt","advis","aim","appropri","artemi","artemis,","artemis.","articles.","assum","basic","befor","between","broad","broker","broker.","brokers.","client","clients.","concept [...]
\ No newline at end of file
diff --git a/src/components/artemis/migration-documentation/ssl.html b/src/components/artemis/migration-documentation/ssl.html
index 36fd8c7..1690365 100644
--- a/src/components/artemis/migration-documentation/ssl.html
+++ b/src/components/artemis/migration-documentation/ssl.html
@@ -7,7 +7,7 @@
<title>SSL · ActiveMQ Artemis Documentation</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.2">
+ <meta name="generator" content="GitBook 3.2.3">
@@ -57,7 +57,7 @@
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
- <link rel="next" href="notice.html" />
+ <link rel="next" href="message-store.html" />
<link rel="prev" href="authorization.html" />
@@ -102,7 +102,33 @@
</li>
- <li class="chapter " data-level="1.2" data-path="configuration.html">
+ <li class="chapter " data-level="1.2" data-path="preface.html">
+
+ <a href="preface.html">
+
+
+ Preface
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="key-differences.html">
+
+ <a href="key-differences.html">
+
+
+ Key Differences
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="configuration.html">
<a href="configuration.html">
@@ -115,7 +141,7 @@
</li>
- <li class="chapter " data-level="1.3" data-path="connectors.html">
+ <li class="chapter " data-level="1.5" data-path="connectors.html">
<a href="connectors.html">
@@ -128,7 +154,7 @@
</li>
- <li class="chapter " data-level="1.4" data-path="destinations.html">
+ <li class="chapter " data-level="1.6" data-path="destinations.html">
<a href="destinations.html">
@@ -141,7 +167,20 @@
</li>
- <li class="chapter " data-level="1.5" data-path="authentication.html">
+ <li class="chapter " data-level="1.7" data-path="VirtualTopics.html">
+
+ <a href="VirtualTopics.html">
+
+
+ Virtual Topics
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.8" data-path="authentication.html">
<a href="authentication.html">
@@ -154,7 +193,7 @@
</li>
- <li class="chapter " data-level="1.6" data-path="authorization.html">
+ <li class="chapter " data-level="1.9" data-path="authorization.html">
<a href="authorization.html">
@@ -167,7 +206,7 @@
</li>
- <li class="chapter active" data-level="1.7" data-path="ssl.html">
+ <li class="chapter active" data-level="1.10" data-path="ssl.html">
<a href="ssl.html">
@@ -180,7 +219,20 @@
</li>
- <li class="chapter " data-level="1.8" data-path="notice.html">
+ <li class="chapter " data-level="1.11" data-path="message-store.html">
+
+ <a href="message-store.html">
+
+
+ Message Store
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.12" data-path="notice.html">
<a href="notice.html">
@@ -317,7 +369,7 @@
</a>
- <a href="notice.html" class="navigation navigation-next " aria-label="Next page: Legal Notice">
+ <a href="message-store.html" class="navigation navigation-next " aria-label="Next page: Message Store">
<i class="fa fa-angle-right"></i>
</a>
@@ -328,7 +380,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"SSL","level":"1.7","depth":1,"next":{"title":"Legal Notice","level":"1.8","depth":1,"path":"notice.md","ref":"notice.md","articles":[]},"previous":{"title":"Authorization","level":"1.6","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css" [...]
+ gitbook.page.hasChanged({"page":{"title":"SSL","level":"1.10","depth":1,"next":{"title":"Message Store","level":"1.11","depth":1,"path":"message-store.md","ref":"message-store.md","articles":[]},"previous":{"title":"Authorization","level":"1.9","depth":1,"path":"authorization.md","ref":"authorization.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":" [...]
});
</script>
</div>