[GitHub] activemq-artemis pull request #943: ARTEMIS-903 Add documentation for updati...

[jbertram <gi...@git.apache.org>]

Github user jbertram commented on a diff in the pull request:

    https://github.com/apache/activemq-artemis/pull/943#discussion_r94613665
  
    --- Diff: docs/user-manual/en/updating-artemis.md ---
    @@ -0,0 +1,25 @@
    +# Updating Artemis
    +
    +The standard Apache ActiveMQ is runnable out of the box. Just download it, 
    +go into the unzipped ActiveMQ folder and run this command: ./bin/activemq run. 
    +The ActiveMQ Artemis sub project needs an additional step to run the Message Queue.
    +Before running activemq run you have to create a new message broker instance. 
    +It looks like an overhead at first glance, but becomes very practically 
    +when updating to a new Artemis version for example. 
    +To create a artemis broker cd into the artemis folder and run: `./bin/artemis create $HOME/mybroker` on the command line.
    +
    +> **Note**
    +>
    +> We recommend choosing a folder different than the downloaded apache-artemis one to separate both from each other.
    +> This separation allowes you run multiple brokers with the same artemis runtime for example. 
    +> It also simplifies updating to newer versions of Artemis.
    +
    --- End diff --
    
    Everything in the above paragraphs is already explained in the "Using the Server" chapter of the documentation.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---