There are different ways to upgrade your website. The steps I take for updating are:
Make sure you have the latest version of EVO 2 which at this moment is 2.0.4.
The tutorial for upgrading from EVO 1 -> 2 can be watched here:
https://forum.evo.im/d/5-how-to-upgrade-evo-1-to-evo-2
If you have a website with Webusers (front-end login users) you need to know in EVO 3 this has been changed.
How to fix that will not be explained here in this tutorial.
EVO 3 needs PHP 7.3 or higher.
First backup your website. Copy all files from FTP. Also you need to backup the database.
In the manager go to Tools > Backup and select all tables by clicking on: Table name
Change the database collation of all tables to utf8_general_ci.
Go to Extras and search for "Migrate 1.4.12 and 2.0.4 to 3.0" and install it.
If you don't do that you will probably get the error message after install:
Table 'modx_active_user_locks' already exists
You need to select the default theme if you have a custom one like I do (custom manager theme will be removed) on the configuration tab, clear cache and logout.
Check if your config file is CHMOD to 644. /core/config/database/connections/default.php
Navigate to: https://my-website.com/assets/update.php (it will upload all needed files for updating) and start installing EVO 3.0.1. (I think you can ignore the MySQL message warning! that doesn't seem to be correct..)
After the website is updated you should update to the latest version of EVO which is 3.0.2. at this moment. Probably when you login the manager you will see the message on the dashboard, Update to EVO 3.0.2 (at this moment latest version) If you see a blank screen after Saving the manager after updating just reload the URL my-site.com/manager
You can clean up the root of your website after you are done.
If you like to do some updates on the Extra's make sure open_basedir is set off on the server! Else some don't show the "installed" message and won't install complete.
The files you can remove are:
- Dockerfile
- config.php.example
- commitizen.config.js
- composer.json
- package-lock.json
- package.json
- README.md
- docker-compose.yml
- folder docker
I prefer to install the latest version again over the updated one with the One click Installer.
If you see the error message:
Base table or view not found: 1146 Table 'xxx_xxx.modx_web_user_attributes' doesn't exist
you need to deactivate plugin UserHelper! (If you would like to update FormLister you also need to update DocLister first..)
You might need to update some Extras, just fully check your site.
If you run into problems or have questions let us know. (General)