[jira] [Commented] (ARTEMIS-2999) Documentation insufficient for updates of existing Artemis installation

["Justin Bertram (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/ARTEMIS-2999?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17233707#comment-17233707 ] 

Justin Bertram commented on ARTEMIS-2999:
-----------------------------------------

bq. Apparently the only bit of information regarding updates of an existing Artemis installation is the "Versions" section of the user manual.

That's not quite accurate. The ["Upgrading" chapter in the documentation|http://activemq.apache.org/components/artemis/documentation/latest/upgrading.html] outlines the general procedure to upgrade an instance from one version to another.

This chapter is also referenced from the "Versions" chapter you mentioned.

bq. How exactly DO I update?

Refer to the aforementioned ["Upgrading" chapter in the documentation|http://activemq.apache.org/components/artemis/documentation/latest/upgrading.html].

bq. ...I had a hard time setting up Artemis initially with the existing documentation...

Which documentation are you referring to specifically? Did you read the ["Using the Server"|http://activemq.apache.org/components/artemis/documentation/latest/using-server.html] chapter which walks through the process of creating and starting/stopping an instance of the broker?

> Documentation insufficient for updates of existing Artemis installation
> -----------------------------------------------------------------------
>
>                 Key: ARTEMIS-2999
>                 URL: https://issues.apache.org/jira/browse/ARTEMIS-2999
>             Project: ActiveMQ Artemis
>          Issue Type: Bug
>    Affects Versions: 2.16.0
>            Reporter: arne anka
>            Priority: Minor
>
> Apparently the only bit of information regarding updates of an existing Artemis installation is the "Versions" section of the user manual.
> But even with 2.16.0 it ends with 2.14 and the instructions for 2.14 are less than helpful:
> "Make sure the existing queues have their parameters set according to the {{broker.xml}} values before upgrading."
>  
>  * What parameters exactly?
>  * How exactly _DO_ I update? Unpack the new archive and copy $INSTANCE over?
>  * $INSTANCE/bin/ scripts are generated during instance creation – are they still valid? Do I need to change anything?
> Since the documentation in general is little user friendly for users that do not work full time with Artemis, I had a hard time setting up Artemis initially with the existing documentation (and judging from my research back then I am far from being alone), and I certainly don't want to jeopardize it now due to a lack of useful directions.
> Would it be possible to revisit this and documentation in general keeping in mind that also users outside of the Artemis community may want to use this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)