Hi, we are looking to upgrade from Matomo 3.1.1. on-premise hosted on our AWS Cloud account. Having gone through a lot of existing questions about this, I saw a lot of people encountering issues when doíng this. What is the recommended path to upgrade to the latest version? Would be best to upgrade to one ore more versions step by step before going straight to the latest from 3.1.1.? Would be great to get some advice on an approach that reduces the chances of downtime. Many thanks!
I would suggest you update:
To the latest 3.x version
Then to the 4.0 version
Then to the latest 4.x version
You may also check if you run the PHP supported versions (in the changelog, there is some PHP versions missings):
This file has been truncated.
# Matomo Platform Changelog
This is the Developer Changelog for Matomo platform developers. All changes in our HTTP APIs, Plugins, Themes, SDKs, etc. are listed below.
The Product Changelog at **[matomo.org/changelog](https://matomo.org/changelog)** lets you see more details about any Matomo release, such as the list of new guides and FAQs, security fixes, and links to all closed issues.
## Matomo 5.0.0
### Breaking Changes
* AngularJS has been completely removed from the code base, existing AngularJS code will no longer work. It is recommended to convert that code to Vue.
* The `Common::fixLbrace()` function has been removed. It was only necessary for AngularJS and no longer needs to be used.
* The deprecated `JSON2` API format has now been removed. We recommend switching to the `JSON` renderer, which behaves the same.
* Plugin names are now limited to 60 characters. If you used to have a plugin with a longer name, you might need to rename it.
* The `instance_id` configuration does no longer support characters other than `a-z`, `0-9` and the special characters `.-_`. If the configured value contains other characters, they will be simply removed.
* When an invalid token is provided in an API request, a 401 response code is now returned instead of 200 response code.
I think update to PHP 7.2.5 could be sufficient.
Many thanks for your quick response and recommendation. We will try this and update this thread with how it went so others can benefit as well. Will be in touch.