From 08b7882c600f737da848898a6c62eecbf045a57e Mon Sep 17 00:00:00 2001
From: Dejan Bosanac <dejan@nighttale.net>
Date: Thu, 23 Feb 2017 11:25:38 +0100
Subject: [PATCH] [docs] migration guide - destinations

---
 docs/migration-guide/en/SUMMARY.md      |  1 +
 docs/migration-guide/en/destinations.md | 30 +++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 docs/migration-guide/en/destinations.md

diff --git a/docs/migration-guide/en/SUMMARY.md b/docs/migration-guide/en/SUMMARY.md
index 5874e8982f..731c94b86c 100644
--- a/docs/migration-guide/en/SUMMARY.md
+++ b/docs/migration-guide/en/SUMMARY.md
@@ -2,4 +2,5 @@
 
 * [Configuration](configuration.md)
 * [Connectors](connectors.md)
+* [Destinations](destinations.md)
 * [Legal Notice](notice.md)
diff --git a/docs/migration-guide/en/destinations.md b/docs/migration-guide/en/destinations.md
new file mode 100644
index 0000000000..069b04c10b
--- /dev/null
+++ b/docs/migration-guide/en/destinations.md
@@ -0,0 +1,30 @@
+Destinations
+=====================================
+
+We already talked about addressing differences between ActiveMQ and Artemis in the [introduction](README.md). Now let's dig into the details and see how to configure JMS queues and topics. It's important to note here that both brokers are configured by default to *auto-create* destinations requested by clients, which is preferred behavior for many use cases. This is configured using authorization security policies, so we will cover this topic in the later sections of this manual. For now, let's see how you can predefine JMS queues and topics in both brokers.
+ 
+In ActiveMQ, destinations are pre-defined in the `<destinations>` section of the `conf/activemq.xml` configuration file.
+
+    <destinations>
+         <queue physicalName="my-queue" />
+         <topic physicalName="my-topic" />
+	</destinations>	
+
+Things looks a bit different in Artemis. We already explained that queues are `anycast` addresses and topics are `muticast` ones. We're not gonna go deep into the address settings details here and you're advised to look at the user manual for that. Let's just see what we need to do in order to replicate ActiveMQ configuration. 
+
+Addresses are defined in `<addresses>` section of the `etc/broker.xml` configuration file. So the corresponding Artemis configuration for the ActiveMQ example above, looks like this:
+
+    <addresses>    
+        <address name="my-queue">
+            <anycast>
+                <queue name="my-queue"/>
+            </anycast>
+        </address>
+
+        <address name="my-topic">
+            <multicast></multicast>
+        </address>
+    </adresses>
+    
+After this step we have our destinations ready in the new broker.    
+        
\ No newline at end of file