Customized Magestore POS Package is the customer environment-specific package, it contains the Original POS Package that you are purchased and all customized works that we have done for you (including bug fixing, new features, integration with 3rd extension).
Notice
This guide applies to install the updated version of Customized 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.
If you are looking for the guide to install a brand new Customized Magestore POS, it’s here.
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 Line 4 (POS Pro 4, POS Pro Commerce 4, POS Enterprise 4, POS Enterprise Commerce 4) 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. Terminate the magestore_pos_process_order
This is a very important step: kill consumers will prevent caching code in the started consumer
Only applied for
POS Enterprise Commerce >= v4.8.0
POS Enterprise >= v4.13.8
POS Pro Commerce >= v4.5.0
POS Pro >= v4.15.0
pgrep -f 'magestore_pos_process_order' | xargs kill -9
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>
8. Run upgrade command (Update POS)
php bin/magento setup:upgrade
9. Deploy POS client
This is a very important step: If you don’t run this command, you can’t access the POS application
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 pgrep -f 'magestore_pos_process_order' | xargs kill -9 rm -rf app/code/Magestore tar -xf <package_name> 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