If you want to know more about all the upgrade steps of the Mautic 3 upgrade process, this is the place to be.
The upgrade process consists of multiple steps to make it as robust as possible. If the process fails at a certain step, you can find all details about the specific error code on the Mautic 3 upgrade errors page.
If you use the web interface to do the upgrade, and you're stuck, you can always go to a specific step by adding the step code to the URL, for example
upgrade_v3.php#buildCache. Please note that manually switching between steps is not supported, only do so when support asks you to do so
Here, Mautic does some checks prior to starting the upgrade, to make sure your system is compatible with the upgrade. The checks are:
api_rate_limiter_cacheset? TODO add docs
spool/defaultfolder? This indicates that there are still emails in the queue
max_execution_timeeither 0 - unlimited - or > 240? If not, Mautic tries to set it, if that doesn't work, Mautic shows an error
mysqldumpavailable for creating database backups?
upgrade temporarily disabledswitch activated? Mautic's Product Team can enable a switch which shows a warning to users that there might be problems with the upgrade. This is only used if there is a major bug with an upgrade path.
memory_limitequal to or higher than 256M? If not, Mautic tries to set it, if that doesn't work, Mautic shows an error
Starts the upgrade and starts logging things as well. In case something goes wrong, you can send your log file on the community support forums so that they can assist further.
mysqldump is available, the upgrade script creates a database backup. Especially on shared hosts this function might not be available.
During this stage the upgrade script is applying any database migration is that remain outstanding for your Mautic 2.16.x instance. This can sometimes happen if a previous update hasn't completed successfully. It's important that your database has all of the updates required before Mautic can proceed.
In this stage the upgrade script is downloading the Mautic 3 upgrade package from the server.
In this stage the upgrade script is extracting the files from the upgrade package and saving them into a folder which Mautic uses for your migration.
This is where a lot of magic happens. The upgrade script takes a complete backup of your Mautic 2 installation, after which it moves the Mautic 3 files into place.
A few configuration parameters have changed in Mautic 3, the upgrade script automatically updates them for you if necessary. To get an overview of all changes configuration parameters, see the update doc.
The database structure has slightly changed in Mautic 3. As part of the standard update process in Mautic, the upgrade script looks for database migrations and executes those.
If you had any custom plugins/themes/media installed in Mautic 2, this step restores those in Mautic 3 by copying them over to the "new" Mautic 3 folder.
In this step, the upgrade script cleans up some of the installation files.
Mautic always prepares cache the first time you start it, so that it runs faster on subsequent requests. In this step, the upgrade script prepares the cache, so that you'll be able to get started easily and quickly.
Cleans up some last files, and allows the user to open Mautic 3.
A last step offered at the end of the upgrade is to remove backup files. Removing the backup files as soon as possible is strongly recommended. This step also removes the upgrade script itself.
Found errors? Think you can improve this documentation? edit this page