Apache
/
activemq-artemis
mirror of https://github.com/apache/activemq-artemis.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

This closes #943

This commit is contained in:
Clebert Suconic 2017-01-05 20:55:13 -05:00
parent 574583e0ed 70ac79b7b8
commit 79647167fa
2 changed files with 26 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/user-manual/en/SUMMARY.md
View File

@ -61,4 +61,4 @@
* [Unit Testing](unit-testing.md) * [Unit Testing](unit-testing.md)
* [Troubleshooting and Performance Tuning](perf-tuning.md) * [Troubleshooting and Performance Tuning](perf-tuning.md)
* [Configuration Reference](configuration-index.md) * [Configuration Reference](configuration-index.md)
* [Updating Artemis](updating-artemis.md)

25
docs/user-manual/en/updating-artemis.md Normal file
View File

@ -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.
Because of this separation it's very easy to update Artemis.
You just need to cd into the `etc` folder of your created message broker and open the `artemis.profile` file.
It contains a property which is relevant for the update procedure:
ARTEMIS_HOME='/Users/.../apache-artemis-X.X.X'
The `ARTEMIS_HOME` property is used to link the broker together with the Artemis runtime.
In case you want to update your broker you can simply download the new version of ActiveMQ Artemis and change the `ARTEMIS_HOME` to the formerly downloaded, newer version.
That's all. There's no need to touch your broker, copy configuration files or stuff like that.