clebertsuconic commented on code in PR #4246: URL: https://github.com/apache/activemq-artemis/pull/4246#discussion_r1010497134
########## 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: @gemmellr I will make one fundamental change here... I will do the opposite.. always replace the whole script... but saving the locations... and telling the user to compare the script with the former backed up for any special adjustments they have done themselves to the scripts. -- 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]
