note

Original Magestore POS Package is the package that only contains Magestore POS product originally (the package is built for widely usage base on Magento fresh installation, not on any customer environment-specific, so it does not contain any specific features/integration/bug fixing for your environment, some unexpected conflict with other extensions may occur when installing or after the POS installed).

Original Magestore POS Package is the package that only contains Magestore POS product originally (the package is built for widely usage base on Magento fresh installation, not on any customer environment-specific, so it does not contain any specific features/integration/bug fixing for your environment, some unexpected conflict with other extensions may occur when installing or after the POS installed).

Notice

This guide applies to install the updated version of Original Magestore POS on your website (the major, minor, or the patch update of your current installed Magestore POS). In case that you want to migrate from the old Magestore POS system or upgrade across lines of POS, please contact with Magestore Support Team to get a suitable guideline.

Compatibility Check

Please check the link below to make sure that the POS version you are having is compatible with your current Magento version.

Prerequisite

Magestore POS Open Source requires MSI to be installed and enabled before installing the POS. You can follow the guide Install Inventory Management from Magento to install and enable MSI.

Update the POS

1. Take a backup of your website

The backup will help you recover faster in case that you are failed while updating Magestore POS due to some conflict with other extensions or unexpected incidents.

2. Turn on Maintenance

php bin/magento maintenance:enable

3. Turn off Magento Cron

php bin/magento cron:remove

4. Turn on Developer mode

php bin/magento deploy:mode:set developer

5. Terminating the magestore_pos_process_order

To prevent caching code in the started consumer

pkill -f magestore_pos_process_order

6. Upload the package to Magento Root Directory

7. Extract the package and copy it to Magento Root Directory

We always distribute the full package to keep the consistency, the full package means it includes all earlier releases of the current package that you are having.

cd <magento_root_directory>
rm -rf app/code/Magestore
tar -xf <package_name>
cp -R server/* ./

8. Run upgrade command (Update POS)

php bin/magento setup:upgrade

9. Deploy POS client

php bin/magento webpos:deploy

10. Run code compilation

php bin/magento setup:di:compile

11. Install Magento Cron

php bin/magento cron:install

12. Reindex All

php bin/magento indexer:reindex

13. Turn on Production mode

php bin/magento deploy:mode:set production

14. Turn off Maintenance

php bin/magento maintenance:disable

Summary

You can use the below script for automating the update process.

Make sure that you change the <magento_root_directory> and <package_name> with the suitable value cause it is the variable. 

cd <magento_root_directory>
php bin/magento maintenance:enable
php bin/magento cron:remove
php bin/magento deploy:mode:set developer
pkill -f magestore_pos_process_order
rm -rf app/code/Magestore
tar -xf <package_name>
cp -R server/* ./
php bin/magento setup:upgrade
php bin/magento webpos:deploy
php bin/magento setup:di:compile
php bin/magento cron:install
php bin/magento indexer:reindex
php bin/magento deploy:mode:set production
php bin/magento maintenance:disable