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.

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.