Repository: activemq-artemis Updated Branches: refs/heads/master fbf3a726c -> c7be36af4
[docs] migration guide - destinations Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/08b7882c Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/08b7882c Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/08b7882c Branch: refs/heads/master Commit: 08b7882c600f737da848898a6c62eecbf045a57e Parents: fbf3a72 Author: Dejan Bosanac <[email protected]> Authored: Thu Feb 23 11:25:38 2017 +0100 Committer: Clebert Suconic <[email protected]> Committed: Thu Feb 23 11:12:19 2017 -0500 ---------------------------------------------------------------------- docs/migration-guide/en/SUMMARY.md | 1 + docs/migration-guide/en/destinations.md | 30 ++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/08b7882c/docs/migration-guide/en/SUMMARY.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/SUMMARY.md b/docs/migration-guide/en/SUMMARY.md index 5874e89..731c94b 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) http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/08b7882c/docs/migration-guide/en/destinations.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/destinations.md b/docs/migration-guide/en/destinations.md new file mode 100644 index 0000000..069b04c --- /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
