From 52841e05f586b4b0f389530804ee7063bc521e2d Mon Sep 17 00:00:00 2001 From: Joseph Anthony Braganza Date: Mon, 4 Mar 2024 10:29:26 +0530 Subject: [PATCH 1/5] updated the getting_started/how_to_update_mautic.rst --- docs/getting_started/how_to_update_mautic.rst | 217 ++++++++++++++++++ 1 file changed, 217 insertions(+) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index 1078d0ef..69cd5ae0 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -75,6 +75,223 @@ This is followed by a prompt to run the command again with this additional argum php bin/console mautic:update:apply --finish +To Update Mautic from 2.x to 3.x +********************************* +If you are on mautic 2.x + then it is better for you to upgrade to 3.x and higher version in this section let's deep dive into upgrading mautic from 2.x to 3.x version. + +Let's Get Started ! + +1. Step One : Fix the data migrations, in your current mautic repo path execute the below commands: + +.. code-block:: shell + + sudo php /var/www/html/mautic/app/console doctrine:migration:migrate + + sudo php /var/www/html/mautic/app/console doctrine:schema:update --force + + sudo -u www-data php /var/www/html/mautic/app/console cache:clear + +The cache clear may take some to get executed. + +After the Migration is done we can go ahead and update the Database ! + +2. Upgrade to 2.16.5 (If you haven't yet) : + +.. code-block:: shell + + cd /var/www/html/mautic + + sudo -u www-data php app/console mautic:update:find + + sudo -u www-data php app/console mautic:update:apply + + +3. Upgrade the to php 7.3 version : + +.. code-block:: shell + + sudo apt upgrade -y + + sudo apt install software-properties-common -y + + sudo add-apt-repository ppa:ondrej/php + + sudo apt update -y + + sudo apt install php7.3 + + sudo apt install php7.3-common php7.3-mysql php7.3-xml php7.3-xmlrpc php7.3-curl php7.3-gd php7.3-imagick php7.3-cli php7.3-dev php7.3-imap php7.3-mbstring php7.3-opcache php7.3-soap php7.3-zip php7.3-intl -y + +4. Edit Your php ini file : + +.. code-block:: shell + + sudo nano /etc/php/7.3/apache2/php.ini + +find the following attributes and change the values of the below variables as shown below. + +short_open_tag = On +memory_limit = 256M +upload_max_filesize = 100M +max_execution_time = 300 +post_max_size = 64M + +5. Activate your php 7.3 Version and turn off 7.1 version : + +.. code-block:: shell + + sudo a2enmod php7.3 + + sudo a2dismod php7.1 + + sudo systemctl restart apache2 + + php -v + + +6. Update the Database + +- Backup your Database : + +.. code-block:: shell + + mysqldump -u root -p --all-databases > all-db.sql + + psw: ysSmK3t87wyC + +- Remove the old mariaDB db : + +.. code-block:: shell + + sudo apt remove mariadb-server + +- Adding a New apt source : + +.. code-block:: shell + + sudo apt install software-properties-common -y + + sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8 + + sudo nano /etc/apt/sources.list.d/mariadb.list + +- Add : + +.. code-block:: shell + + deb [arch=amd64,arm64,ppc64el] + http://nyc2.mirrors.digitalocean.com/mariadb/repo/10.4/ubuntu bionic main + deb-src http://nyc2.mirrors.digitalocean.com/mariadb/repo/10.4/ubuntu bionic main + + +- Update and Install the New Version of mariaDB : + +.. code-block:: shell + + sudo apt update + + sudo apt install mariadb-server -y + + exit + +- Remove the Non-compatible plugins : + +.. code-block:: shell + + cd /var/www/html/mautic/ + + sudo -u www-data php /var/www/html/mautic/app/console mautic:update:find + +- Search for the Upgrade : + +.. note:: + + This step really depends on your installed and non-M3 compatible plugins. + +.. code-block:: shell + + cd /var/www/html/mautic/plugins + + rm -R GautitClearcacheBundle/ + rm -R MauticAdvancedTemplatesBundle/ + rm -R SmsreaderBundle/ + +Optionally in this step we could also just move them out from this folder : + +.. code-block:: shell + + mv /var/www/html/mautic/plugins/GautitClearcacheBundle /var/www/html + mv /var/www/html/mautic/plugins/MauticAdvancedTemplatesBundle /var/www/html + mv /var/www/html/mautic/plugins/MauticRecaptchaBundle /var/www/html + mv /var/www/html/mautic/plugins/SmsreaderBundle /var/www/html + + + +7. Installing Mautic 3 + +To start can execute the below commands : + +.. code-block:: shell + + sudo -u www-data php upgrade_v3.php + +If you installed via composer originally, you will need to use this trick : + +.. code-block:: shell + + mv composer.json composer.json2 + sudo -u www-data php upgrade_v3.php + +- If you get an error here just check if the ownership permissions are set properly + +then run the upgrage again : + +.. code-block:: shell + + sudo -u www-data php upgrade_v3.php + +8. Looking for new versions in 3.0 and then updating it 3.0+ : + +.. code-block:: shell + + sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:find + sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply + sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply --finish + +- set ownership and clear the cache : + +.. code-block:: shell + + sudo chown -R www-data:www-data /var/www/html/mautic/ + sudo chmod -R 755 /var/www/html/mautic/ + sudo -u www-data php /var/www/html/mautic/bin/console cache:clear + + +9. Last Step: + +Change your cron jobs from : + +.. code-block:: shell + + /app/console + +to : + +.. code-block:: shell + + /bin/console + +- If you would like to use the new Email Builder, go to plugins, click on install plugins and turn on the new builder. + You might need to log in and out before it's actvated. + +There you go finally upgraded to mautic 3.0 !!! + + + + + + + Updating in the browser *********************** From e93769f7f9d108810b663a8751a9f175a9a63684 Mon Sep 17 00:00:00 2001 From: Joseph Anthony Braganza Date: Tue, 5 Mar 2024 10:15:50 +0530 Subject: [PATCH 2/5] Added the 3.x to 4.x update docs --- docs/getting_started/how_to_update_mautic.rst | 167 ++++++++++++++++++ 1 file changed, 167 insertions(+) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index 69cd5ae0..8b5f6bf8 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -286,11 +286,178 @@ to : There you go finally upgraded to mautic 3.0 !!! +If you are already on 3.x+ version and want to upgrade it to 4.x we got you covered check the below documentation. +To Update Mautic from 3.x to 4.x +********************************* +- Mautic 4 is the most stable release,It is already being used by many customers.When it was upgraded from Mautic 2 to Mautic 3,It had several issues with the database structure and even the file system.Here is a simple guide to go ahead !. + +You need to be at the root folder which is the /var/www/html/ currently where the mautic code resides. + +1. First step is to backup the file system , as said you need to be at /var/www/html/ for upgrading and for executing the commands given below: +the below command is used to backup your file system : + +.. code-block:: shell + + zip -r output_file.zip folder1 + +2. Backup your Database + +.. code-block:: shell + + mysqldump -u [user_name] -p [password] [mautic database_name] > [dumpfilename.sql] + +you can then check if your files are created By running the below command : + +.. code-block:: shell + + ls -la + +you should see the .sql and .zip files generated by running the above command. + +3. Updating your current Environment +- Updating your php version from php7.3 to php7.4 and updating rest packages : + +.. code-block:: shell + + apt install mariadb-server apache2 libapache2-mod-php7.4 php7.4 unzip php7.4-xml php7.4-mysql php7.4-imap php7.4-zip php7.4-intl php7.4-curl php7.4-gd php7.4-mbstring php7.4-bcmath ntp -y + +- Now lets change the Environment Variables : + +.. code-block:: shell + + sudo nano /etc/php/7.4/apache2/php.ini + +after running this command one should change the following variables values accordingly : + +.. code-block:: shell + + file_uploads = On + allow_url_fopen = On + short_open_tag = On + memory_limit = 256M + upload_max_filesize = 100M + max_execution_time = 300 + post_max_size = 64M + +.. note:: + + Regarding memory limit, you can be more generous and lift to 512M as well. Upload max filessize is also up to you. I suggest a minimum of 20MB. + +4. Now move to php4 officially, and restart our Apache : + +.. code-block:: shell + + sudo a2enmod php7.4 + sudo a2dismod php7.3 + sudo systemctl restart apache2 + +and then check the current version of the php which is been used : + +.. code-block:: shell + + php -v + +.. note:: + If you get something like this : + .. code-block:: shell + + PHP 7.4.23 (cli) (built: Aug 26 2021 15:51:37) ( NTS ) + Copyright (c) The PHP Group + Zend Engine v3.4.0, Copyright (c) Zend Technologies + with Zend OPcache v7.4.23, Copyright (c), by Zend Technologies + +then we need to stop the cron jobs running in the background + +.. code-block:: shell + + sudo crontab -e +one fix is that you can add a # in front of the cron commands, like: +.. code-block:: shell + + # * * * * * CRONJOBS HERE + +5. Command Line Update ! +- In order to create more tension we will do this in 2 steps. First we update to 3.3.4 and then to 4.0.1. + +Let's look for a new version: + +.. code-block:: shell + + cd /var/www/html/mautic + sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:find + +after finding the latest version we need to apply it : + +.. code-block:: shell + + sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply + +.. note:: + Now we are prompted to apply finish. I would like to stop here for a moment. I know, that it is not the right way to use sudo when you are working here, but it is just simpler for folks if we don't go into permissions. But using a root user during updates can cause file creation with the wrong ownership. In order to avoid it we will make sure by almost every step that the files belong to the right user. So we hand over the files to the www-data user all the time (which is running our we server.) + +- We do it by running this: + +.. code-block:: shell + + sudo chown -R www-data:www-data /var/www/html/mautic/ + sudo chmod -R 755 /var/www/html/mautic/ + +- and now we can finish it by the following command : +.. code-block:: shell + + sudo -u www-data php /var/www/html/mautic/bin/console + mautic:update:apply --finish + +- If everything went well, we are on the 3.3.4 version, half way to 4.0.1. Let's look for a new version, and apply changes: + +.. code-block:: shell + + sudo -u www-data php /var/www/html/mautic/bin/console + mautic:update:find + sudo -u www-data php /var/www/html/mautic/bin/console + mautic:update:apply + +.. note:: + make sure that the file permissions is okay : + +.. code-block:: shell + + sudo chown -R www-data:www-data /var/www/html/mautic/ + + sudo chmod -R 755 /var/www/html/mautic/ + +And here comes the last step We are here ! Take a deep breath : + +.. code-block:: shell + + sudo -u www-data php /var/www/html/mautic/bin/console + mautic:update:apply --finish + +Congrats you are on Mautic 4.x version give yourself a pat on your back ! + +.. note:: + + Need to make sure your templates are okay. Make sure, + that all of your email / landing page templates have the following config file + format especially the red line: + +.. code-block:: shell + { + "name": "Template name", + "author": "Mautic team", + "authorUrl": "https://mautic.org", + "builder": ["grapesjsbuilder"], + "features": [ + "email" + ] + } +- If you are upgrading from a previous version, all your templates will have “builder”: “grapesjsbuilder”, + format, and you really need those brackets now. Updating in the browser *********************** From 5e475bb770fb95509ff12557310e5f82fb2e733e Mon Sep 17 00:00:00 2001 From: Joseph Anthony Braganza Date: Sun, 17 Mar 2024 15:17:53 +0530 Subject: [PATCH 3/5] updated the changes accordingly to the PR --- docs/getting_started/how_to_update_mautic.rst | 119 +++++++----------- 1 file changed, 45 insertions(+), 74 deletions(-) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index 8b5f6bf8..4ea07017 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -80,16 +80,18 @@ To Update Mautic from 2.x to 3.x If you are on mautic 2.x + then it is better for you to upgrade to 3.x and higher version in this section let's deep dive into upgrading mautic from 2.x to 3.x version. Let's Get Started ! +.. note:: + if you are not already operating with elevated privileges or have not set up the necessary permissions in your system configuration, you may be able to run these commands with sudo. -1. Step One : Fix the data migrations, in your current mautic repo path execute the below commands: +1. Step One : Fix the data migrations, in your current mautic repo path execute the below commands inside (cd /path/to/your/mautic) : .. code-block:: shell - sudo php /var/www/html/mautic/app/console doctrine:migration:migrate + php app/console doctrine:migration:migrate - sudo php /var/www/html/mautic/app/console doctrine:schema:update --force + php app/console doctrine:schema:update --force - sudo -u www-data php /var/www/html/mautic/app/console cache:clear + sudo -u www-data php app/console cache:clear The cache clear may take some to get executed. @@ -99,7 +101,7 @@ After the Migration is done we can go ahead and update the Database ! .. code-block:: shell - cd /var/www/html/mautic + cd /path/to/your/mautic sudo -u www-data php app/console mautic:update:find @@ -110,17 +112,17 @@ After the Migration is done we can go ahead and update the Database ! .. code-block:: shell - sudo apt upgrade -y + apt upgrade -y - sudo apt install software-properties-common -y + apt install software-properties-common -y - sudo add-apt-repository ppa:ondrej/php + add-apt-repository ppa:ondrej/php - sudo apt update -y + apt update -y - sudo apt install php7.3 + apt install php7.3 - sudo apt install php7.3-common php7.3-mysql php7.3-xml php7.3-xmlrpc php7.3-curl php7.3-gd php7.3-imagick php7.3-cli php7.3-dev php7.3-imap php7.3-mbstring php7.3-opcache php7.3-soap php7.3-zip php7.3-intl -y + apt install php7.3-common php7.3-mysql php7.3-xml php7.3-xmlrpc php7.3-curl php7.3-gd php7.3-imagick php7.3-cli php7.3-dev php7.3-imap php7.3-mbstring php7.3-opcache php7.3-soap php7.3-zip php7.3-intl -y 4. Edit Your php ini file : @@ -140,11 +142,11 @@ post_max_size = 64M .. code-block:: shell - sudo a2enmod php7.3 + a2enmod php7.3 - sudo a2dismod php7.1 + a2dismod php7.1 - sudo systemctl restart apache2 + systemctl restart apache2 php -v @@ -157,23 +159,23 @@ post_max_size = 64M mysqldump -u root -p --all-databases > all-db.sql - psw: ysSmK3t87wyC + psw: "ENTER_YOUR_PASSWORD" - Remove the old mariaDB db : .. code-block:: shell - sudo apt remove mariadb-server + apt remove mariadb-server - Adding a New apt source : .. code-block:: shell - sudo apt install software-properties-common -y + apt install software-properties-common -y - sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8 + apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8 - sudo nano /etc/apt/sources.list.d/mariadb.list + nano /etc/apt/sources.list.d/mariadb.list - Add : @@ -188,43 +190,12 @@ post_max_size = 64M .. code-block:: shell - sudo apt update + apt update - sudo apt install mariadb-server -y + apt install mariadb-server -y exit -- Remove the Non-compatible plugins : - -.. code-block:: shell - - cd /var/www/html/mautic/ - - sudo -u www-data php /var/www/html/mautic/app/console mautic:update:find - -- Search for the Upgrade : - -.. note:: - - This step really depends on your installed and non-M3 compatible plugins. - -.. code-block:: shell - - cd /var/www/html/mautic/plugins - - rm -R GautitClearcacheBundle/ - rm -R MauticAdvancedTemplatesBundle/ - rm -R SmsreaderBundle/ - -Optionally in this step we could also just move them out from this folder : - -.. code-block:: shell - - mv /var/www/html/mautic/plugins/GautitClearcacheBundle /var/www/html - mv /var/www/html/mautic/plugins/MauticAdvancedTemplatesBundle /var/www/html - mv /var/www/html/mautic/plugins/MauticRecaptchaBundle /var/www/html - mv /var/www/html/mautic/plugins/SmsreaderBundle /var/www/html - 7. Installing Mautic 3 @@ -250,21 +221,21 @@ then run the upgrage again : sudo -u www-data php upgrade_v3.php -8. Looking for new versions in 3.0 and then updating it 3.0+ : +8. Looking for new versions in 3.0 and then updating it 3.0+ (inside your mautic folder) : .. code-block:: shell - sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:find - sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply - sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply --finish + sudo -u www-data php bin/console mautic:update:find + sudo -u www-data php bin/console mautic:update:apply + sudo -u www-data php bin/console mautic:update:apply --finish - set ownership and clear the cache : .. code-block:: shell - sudo chown -R www-data:www-data /var/www/html/mautic/ - sudo chmod -R 755 /var/www/html/mautic/ - sudo -u www-data php /var/www/html/mautic/bin/console cache:clear + chown -R www-data:www-data /path/to/your/mautic/ + chmod -R 755 /path/to/your/mautic/ + sudo -u www-data php bin/console cache:clear 9. Last Step: @@ -326,7 +297,7 @@ you should see the .sql and .zip files generated by running the above command. .. code-block:: shell - sudo nano /etc/php/7.4/apache2/php.ini + nano /etc/php/7.4/apache2/php.ini after running this command one should change the following variables values accordingly : @@ -348,9 +319,9 @@ after running this command one should change the following variables values acco .. code-block:: shell - sudo a2enmod php7.4 - sudo a2dismod php7.3 - sudo systemctl restart apache2 + a2enmod php7.4 + a2dismod php7.3 + systemctl restart apache2 and then check the current version of the php which is been used : @@ -386,14 +357,14 @@ Let's look for a new version: .. code-block:: shell - cd /var/www/html/mautic - sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:find + cd /path/to/your/mautic/ + sudo -u www-data php bin/console mautic:update:find after finding the latest version we need to apply it : .. code-block:: shell - sudo -u www-data php /var/www/html/mautic/bin/console mautic:update:apply + sudo -u www-data php bin/console mautic:update:apply .. note:: Now we are prompted to apply finish. I would like to stop here for a moment. I know, that it is not the right way to use sudo when you are working here, but it is just simpler for folks if we don't go into permissions. But using a root user during updates can cause file creation with the wrong ownership. In order to avoid it we will make sure by almost every step that the files belong to the right user. So we hand over the files to the www-data user all the time (which is running our we server.) @@ -402,23 +373,23 @@ after finding the latest version we need to apply it : .. code-block:: shell - sudo chown -R www-data:www-data /var/www/html/mautic/ - sudo chmod -R 755 /var/www/html/mautic/ + chown -R www-data:www-data /path/to/your/mautic/ + chmod -R 755 /path/to/your/mautic/ - and now we can finish it by the following command : .. code-block:: shell - sudo -u www-data php /var/www/html/mautic/bin/console + sudo -u www-data php /path/to/your/mautic/bin/console mautic:update:apply --finish - If everything went well, we are on the 3.3.4 version, half way to 4.0.1. Let's look for a new version, and apply changes: .. code-block:: shell - sudo -u www-data php /var/www/html/mautic/bin/console + sudo -u www-data php /path/to/your/mautic/bin/console mautic:update:find - sudo -u www-data php /var/www/html/mautic/bin/console + sudo -u www-data php /path/to/your/mautic/bin/console mautic:update:apply .. note:: @@ -426,15 +397,15 @@ after finding the latest version we need to apply it : .. code-block:: shell - sudo chown -R www-data:www-data /var/www/html/mautic/ + chown -R www-data:www-data /path/to/your/mautic/ - sudo chmod -R 755 /var/www/html/mautic/ + chmod -R 755 /path/to/your/mautic/ And here comes the last step We are here ! Take a deep breath : .. code-block:: shell - sudo -u www-data php /var/www/html/mautic/bin/console + sudo -u www-data php /path/to/your/mautic/bin/console mautic:update:apply --finish Congrats you are on Mautic 4.x version give yourself a pat on your back ! From 309824288d7156a87dedd44e4ee93b1760100b7d Mon Sep 17 00:00:00 2001 From: Joseph Anthony Braganza Date: Sun, 17 Mar 2024 15:21:39 +0530 Subject: [PATCH 4/5] updated the code --- docs/getting_started/how_to_update_mautic.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index 4ea07017..a5a08ad6 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -80,7 +80,9 @@ To Update Mautic from 2.x to 3.x If you are on mautic 2.x + then it is better for you to upgrade to 3.x and higher version in this section let's deep dive into upgrading mautic from 2.x to 3.x version. Let's Get Started ! + .. note:: + if you are not already operating with elevated privileges or have not set up the necessary permissions in your system configuration, you may be able to run these commands with sudo. 1. Step One : Fix the data migrations, in your current mautic repo path execute the below commands inside (cd /path/to/your/mautic) : From ad55e157308505316a87820398991b4f6a5b9e95 Mon Sep 17 00:00:00 2001 From: Joseph Anthony Braganza Date: Wed, 17 Apr 2024 23:44:27 +0530 Subject: [PATCH 5/5] Updated the how to updated Mautic Page --- docs/getting_started/how_to_update_mautic.rst | 53 ++++++++++--------- 1 file changed, 28 insertions(+), 25 deletions(-) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index a5a08ad6..129357a2 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -77,15 +77,15 @@ This is followed by a prompt to run the command again with this additional argum To Update Mautic from 2.x to 3.x ********************************* -If you are on mautic 2.x + then it is better for you to upgrade to 3.x and higher version in this section let's deep dive into upgrading mautic from 2.x to 3.x version. +If you are on Mautic 2.x + then it is better for you to upgrade to 3.x and higher version in this section let's deep dive into upgrading Mautic from 2.x to 3.x version. -Let's Get Started ! +Getting Started ! .. note:: - if you are not already operating with elevated privileges or have not set up the necessary permissions in your system configuration, you may be able to run these commands with sudo. + if you are not already operating with elevated privileges or have not set up the necessary permissions in your system configuration, you may be able to run these commands with SUDO. -1. Step One : Fix the data migrations, in your current mautic repo path execute the below commands inside (cd /path/to/your/mautic) : +1. Step One : Fix the data migrations, in your current Mautic repository path execute the below commands inside (cd /path/to/your/Mautic) : .. code-block:: shell @@ -110,7 +110,7 @@ After the Migration is done we can go ahead and update the Database ! sudo -u www-data php app/console mautic:update:apply -3. Upgrade the to php 7.3 version : +3. Upgrade the to PHP 7.3 version : .. code-block:: shell @@ -126,21 +126,22 @@ After the Migration is done we can go ahead and update the Database ! apt install php7.3-common php7.3-mysql php7.3-xml php7.3-xmlrpc php7.3-curl php7.3-gd php7.3-imagick php7.3-cli php7.3-dev php7.3-imap php7.3-mbstring php7.3-opcache php7.3-soap php7.3-zip php7.3-intl -y -4. Edit Your php ini file : +4. Edit Your PHP INI file : .. code-block:: shell sudo nano /etc/php/7.3/apache2/php.ini -find the following attributes and change the values of the below variables as shown below. +Find the following attributes and change the values of the below variables as shown below: -short_open_tag = On -memory_limit = 256M -upload_max_filesize = 100M -max_execution_time = 300 -post_max_size = 64M +- `short_open_tag = On` +- `memory_limit = 256M` +- `upload_max_filesize = 100M` +- `max_execution_time = 300` +- `post_max_size = 64M` -5. Activate your php 7.3 Version and turn off 7.1 version : + +5. Activate your PHP 7.3 Version and turn off 7.1 version : .. code-block:: shell @@ -208,7 +209,7 @@ To start can execute the below commands : sudo -u www-data php upgrade_v3.php -If you installed via composer originally, you will need to use this trick : +If you installed via Composer originally, you will need to use this trick : .. code-block:: shell @@ -217,13 +218,13 @@ If you installed via composer originally, you will need to use this trick : - If you get an error here just check if the ownership permissions are set properly -then run the upgrage again : +then run the upgrade again : .. code-block:: shell sudo -u www-data php upgrade_v3.php -8. Looking for new versions in 3.0 and then updating it 3.0+ (inside your mautic folder) : +8. Looking for new versions in 3.0 and then updating it 3.0+ (inside your Mautic folder) : .. code-block:: shell @@ -255,25 +256,27 @@ to : /bin/console - If you would like to use the new Email Builder, go to plugins, click on install plugins and turn on the new builder. - You might need to log in and out before it's actvated. + You might need to log in and out before it's activated. -There you go finally upgraded to mautic 3.0 !!! +There you go finally upgraded to Mautic 3.0 !!! If you are already on 3.x+ version and want to upgrade it to 4.x we got you covered check the below documentation. To Update Mautic from 3.x to 4.x ********************************* -- Mautic 4 is the most stable release,It is already being used by many customers.When it was upgraded from Mautic 2 to Mautic 3,It had several issues with the database structure and even the file system.Here is a simple guide to go ahead !. -You need to be at the root folder which is the /var/www/html/ currently where the mautic code resides. +- Mautic 4 is the most stable release. It is already being used by many customers. When it was upgraded from Mautic 2 to Mautic 3, it had several issues with the database structure and even the file system. Here is a simple guide to go ahead! + +You need to be at the root folder which is the /var/www/HTML/ currently where the Mautic code resides. -1. First step is to backup the file system , as said you need to be at /var/www/html/ for upgrading and for executing the commands given below: -the below command is used to backup your file system : +1. First step is to backup the file system, as said you need to be at /var/www/HTML/ for upgrading and for executing the commands given below: +the below command is used to backup your file system: .. code-block:: shell zip -r output_file.zip folder1 + 2. Backup your Database .. code-block:: shell @@ -289,7 +292,7 @@ you can then check if your files are created By running the below command : you should see the .sql and .zip files generated by running the above command. 3. Updating your current Environment -- Updating your php version from php7.3 to php7.4 and updating rest packages : +- Updating your PHP version from PHP7.3 to PHP7.4 and updating rest packages : .. code-block:: shell @@ -315,7 +318,7 @@ after running this command one should change the following variables values acco .. note:: - Regarding memory limit, you can be more generous and lift to 512M as well. Upload max filessize is also up to you. I suggest a minimum of 20MB. + Regarding memory limit, you can be more generous and lift to 512M as well. Upload max file size is also up to you. I suggest a minimum of 20MB. 4. Now move to php4 officially, and restart our Apache : @@ -338,7 +341,7 @@ and then check the current version of the php which is been used : PHP 7.4.23 (cli) (built: Aug 26 2021 15:51:37) ( NTS ) Copyright (c) The PHP Group Zend Engine v3.4.0, Copyright (c) Zend Technologies - with Zend OPcache v7.4.23, Copyright (c), by Zend Technologies + with Zend OPcache v7.4.23, Copyright (c), by Zend Technologies then we need to stop the cron jobs running in the background