25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
|
# 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.
|