Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id D6693200C34 for ; Mon, 27 Feb 2017 18:09:04 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id D351F160B5B; Mon, 27 Feb 2017 17:09:04 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id CBFA9160B60 for ; Mon, 27 Feb 2017 18:09:03 +0100 (CET) Received: (qmail 98203 invoked by uid 500); 27 Feb 2017 17:09:03 -0000 Mailing-List: contact commits-help@activemq.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@activemq.apache.org Delivered-To: mailing list commits@activemq.apache.org Received: (qmail 98110 invoked by uid 99); 27 Feb 2017 17:09:03 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 27 Feb 2017 17:09:03 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id D2150DFDE6; Mon, 27 Feb 2017 17:09:02 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: martyntaylor@apache.org To: commits@activemq.apache.org Date: Mon, 27 Feb 2017 17:09:03 -0000 Message-Id: In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [2/2] activemq-artemis git commit: DOCS: Fixing apparent typo on Connectors and small cosmetic change for XML on Markdown archived-at: Mon, 27 Feb 2017 17:09:05 -0000 DOCS: Fixing apparent typo on Connectors and small cosmetic change for XML on Markdown Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/412ec945 Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/412ec945 Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/412ec945 Branch: refs/heads/master Commit: 412ec94571c6fb6976963dcb2f82f6a520066056 Parents: 3d503ac Author: Clebert Suconic Authored: Sat Feb 25 11:14:58 2017 -0500 Committer: Martyn Taylor Committed: Mon Feb 27 17:08:26 2017 +0000 ---------------------------------------------------------------------- docs/migration-guide/en/authentication.md | 14 ++++++---- docs/migration-guide/en/configuration.md | 31 ++++++++++++++-------- docs/migration-guide/en/connectors.md | 36 ++++++++++++++------------ docs/migration-guide/en/destinations.md | 35 +++++++++++++------------ 4 files changed, 67 insertions(+), 49 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/412ec945/docs/migration-guide/en/authentication.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/authentication.md b/docs/migration-guide/en/authentication.md index 35fe088..637da89 100644 --- a/docs/migration-guide/en/authentication.md +++ b/docs/migration-guide/en/authentication.md @@ -5,18 +5,22 @@ Now that we have our acceptors and addresses ready, it's time to deal with broke Both ActiveMQ and Artemis use JAAS to define authentication credentials. In ActiveMQ, that's configured through the appropriate broker plugin in `conf/activemq.xml` - - - +```xml + + + +``` The name of the JAAS domain is specified as a configuration parameter. In Artemis, the same thing is achieved by defining `` configuration in `etc/bootstrap.xml` - +```xml + +``` From this point on, you can go and define your users and their roles in appropriate files, like `conf/users.properties` and `conf/groups.properties` in ActiveMQ. Similarly, `etc/artemis-users.properties` and `etc/artemis-roles.properties` files are used in Artemis. These files are intechangable, so you should be able to just copy your existing configuration over to the new broker. If your deployment is more complicated that this and requires some advanced JAAS configuration, you'll need go and change the `etc/login.config` file. It's important to say that all custom JAAS modules and configuration you were using in ActiveMQ should be compatible with Artemis. -Finally, in case you're still using ActiveMQ's *Simple Authentication Plugin*, which defines users and groups directly in the broker's xml configuration file, you'll need to migrate to JAAS as Artemis doesn't support the similar concept. \ No newline at end of file +Finally, in case you're still using ActiveMQ's *Simple Authentication Plugin*, which defines users and groups directly in the broker's xml configuration file, you'll need to migrate to JAAS as Artemis doesn't support the similar concept. http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/412ec945/docs/migration-guide/en/configuration.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/configuration.md b/docs/migration-guide/en/configuration.md index 7c53539..397f916 100644 --- a/docs/migration-guide/en/configuration.md +++ b/docs/migration-guide/en/configuration.md @@ -28,31 +28,40 @@ Finally, we have JAAS configuration files (`login.config`, `artemis-users.proper 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 - $ bin/artemis run +```sh +$ bin/artemis run +``` This is the same as - $ bin/activemq console - +```sh +$ bin/activemq console +``` command in ActiveMQ. For running the broker as a service, Artemis provides a separate shell script `bin/artemis-service`. So you can run the broker in the background like - - $ bin/artemis-service start +```sh +$ bin/artemis-service start +``` This is the same as running ActiveMQ with - - $ bin/activemq start +```sh +$ bin/activemq start +``` After the start, you can check the broker status in `logs/artemis.log` file. Congratulations, you have your Artemis broker up and running. By default, Artemis starts *Openwire* connector on the same port as ActiveMQ, so clients can connect. To test this you can go to your existing ActiveMQ instance and run the following commands. - $ bin/activemq producer - $ bin/activemq consumer +````sh +$ bin/activemq producer +$ bin/activemq consumer +```` You should see the messages flowing through the broker. Finally, we can stop the broker with - $ bin/artemis-service stop +```sh +$ bin/artemis-service stop +``` -With this, our orienteering session around Artemis is finished. In the following articles we'll start digging deeper into the configuration details and differences between two brokers and see how that can affect your messaging applications. \ No newline at end of file +With this, our orienteering session around Artemis is finished. In the following articles we'll start digging deeper into the configuration details and differences between two brokers and see how that can affect your messaging applications. http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/412ec945/docs/migration-guide/en/connectors.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/connectors.md b/docs/migration-guide/en/connectors.md index 8119007..a55cb95 100644 --- a/docs/migration-guide/en/connectors.md +++ b/docs/migration-guide/en/connectors.md @@ -3,24 +3,26 @@ Connectors After broker is started, you'll want to connect your clients to it. So, let's start with comparing ActiveMQ and Artemis configurations in area of client connectors. In ActiveMQ terminology, they are called *transport connectors*, and the default configuration looks something like this (in `conf/activemq.xml`). - - - - - - - +```xml + + + + + + + +``` In Artemis, client connectors are called *acceptors* and they are configured in `etc/broker.xml` like this - - - tcp://0.0.0.0:61616?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=CORE,AMQP,STOMP,HORNETQ,MQTT,OPENWIRE - tcp://0.0.0.0:5672?protocols=AMQP - tcp://0.0.0.0:61613?protocols=STOMP - tcp://0.0.0.0:5445?protocols=HORNETQ,STOMP - tcp://0.0.0.0:1883?protocols=MQTT - - +```xml + + tcp://0.0.0.0:61616?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=CORE,AMQP,STOMP,HORNETQ,MQTT,OPENWIRE + tcp://0.0.0.0:5672?protocols=AMQP + tcp://0.0.0.0:61613?protocols=STOMP + tcp://0.0.0.0:5445?protocols=HORNETQ,STOMP + tcp://0.0.0.0:1883?protocols=MQTT + +``` As you can notice the syntax is very similar, but there are still some differences that we need to understand. First, as we said earlier, there's no notion of blocking and non-blocking (nio) transport in Artemis, so you should treat everything as non-blocking. Also, in Artemis the low level transport is distinct from the actual messaging protocol (like AMQP or MQTT) used on top of it. One acceptor can handle multiple messaging protocols on the same port. By default, all protocols are accepted on the single port, but you can restrict this using the `protocols=X,Y` uri attribute pattern as shown in the example above. Besides *tcp* network protocol, Artemis support *InVm* and *Web Socket* transports. The *InVm* transport is similar to ActiveMQ's *vm* transport and is used to connect clients to the embedded broker. The difference is that you can use any messaging protocol on top of *InVm* transport in Artemis, while *vm* transport in ActiveMQ is tied to OpenWire. @@ -29,7 +31,7 @@ One of the advantages of using Netty for IO layer, is that Web Sockets are suppo To summarize this topic, here's a table that shows you how to migrate your ActiveMQ transport connectors to the Artemis acceptors -| ActiveMQ | Artemis (p[tions in the acceptor URL) | +| ActiveMQ | Artemis (options in the acceptor URL) | |---|---| | OpenWire | protocols=OpenWire (version 10+) | | NIO | - | http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/412ec945/docs/migration-guide/en/destinations.md ---------------------------------------------------------------------- diff --git a/docs/migration-guide/en/destinations.md b/docs/migration-guide/en/destinations.md index 069b04c..5753c28 100644 --- a/docs/migration-guide/en/destinations.md +++ b/docs/migration-guide/en/destinations.md @@ -5,26 +5,29 @@ We already talked about addressing differences between ActiveMQ and Artemis in t In ActiveMQ, destinations are pre-defined in the `` section of the `conf/activemq.xml` configuration file. - - - - +```xml + + + + +``` 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 `` section of the `etc/broker.xml` configuration file. So the corresponding Artemis configuration for the ActiveMQ example above, looks like this: - -

- - - -

+```xml + +

+ + + +

- -

- +

+ +

+ +``` -After this step we have our destinations ready in the new broker. - \ No newline at end of file +After this step we have our destinations ready in the new broker.