Upgrading MPOS

Description

This guide will help you to upgrade your existing MPOS instance to the latest version. Keep in mind that MPOS is heavily relying on git so make sure you cloned properly.

Checking for Changes

This, luckily, is pretty easy to do! Please check your local checkout for the most recent commit version:

git log
git log -1
commit 93dd7c92a644d27dcf74f42aa641e1d628b5e6e7
[...]

You are looking at the commit 93dd7c92a644d27dcf74f42aa641e1d628b5e6e7 line. Copy that string. Now you can go to Github and compare your version against my latest one:

https://github.com/TheSerapher/php-mpos/compare/93dd7c92a644d27dcf74f42aa641e1d628b5e6e7...next

This will show all changes between your locally installed version and what's available in my current next. You will have to keep a close eye on any SQL files added there! You will need to import them later.

Maintenance Mode

Enable the maintenance mode in MPOS. This will at least notify the users you are working on an update. If you wish you can also disable the cronjobs. In general not a bad idea, though during the upgrade crons will be disabled anyway if any manual steps are required.

git pull

First step of business is fetching the new updates. If you are running on a direct clone on the next branch, just calling git pull will bring you to the latest changes. Please note the output when doing git pull. It will list a bunch of file updates and added files.

Core Changes

SQL Upgrades

If you checked your output of git pull you should keep an eye on filed add to the sql folder. You will need to import any newly added SQL upgrades.

Configuration Upgrades

As above, also note changes to the global.inc.dist.php: If this file has been updated it probably means that configuration options have changed. You can either run a diff global.inc.php global.inc.dist.php to see what changed or go through the files yourself. Most of the time it's just a few lines that have either changed or added. Fix those in your local global.inc.php and increment the version after you are sure all options have been added.

Disable Maintenance

Now with your core code updated via git pull, SQL files imported and configuration files updated, you can disable maintenance mode! Re-enable your crons (if you disabled them, as you should!) and check for any errors.

Summary

This is a temporary guide. Once we complete our release tags this will be updated to properly work with those.