gemmellr commented on code in PR #4246: URL: https://github.com/apache/activemq-artemis/pull/4246#discussion_r1010616240
########## docs/user-manual/en/upgrading.md: ########## @@ -48,3 +48,23 @@ most cases_ the instance can be upgraded to a newer version simply by changing the value of this property to the location of the new broker home. Please refer to the aforementioned [versions](versions.md) document for additional upgrade steps (if required). + +It is also possible to do these steps automatically as it can be seen in the next section. + +## Upgrading tool + +An automatic approach can be used to upgrade the instance. You may simply call `./artemis upgrade <old-instance>`. + +```shell +cd $NEW_ARTEMIS_DOWNLOAD/bin/ +./artemis upgrade PATH_TO_UPGRADING_INSTANCE +``` + +artemis, artemis.profile will be updated to the new version. + +The tool will also update log4j2.properties (if you are migrating from a version previous to 2.27.0). + +> **Note:** +> +>to avoid removing eventual user's customizations, the upgrade process won't automatically bring new additions to the scripts itself. Please compare your artemis and artemis.profile to newer versions after the upgrade. Review Comment: I think that ultimately works better for the user, and shoudl be simpler to implement. Means the user just has one command to run, and they can see all the differences to their earlier config and pick our any of their own customisations they still want. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
