How to Install Updated Customized Magestore POS via SSH
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).
- 1 Notice
- 2 Compatibility Check
- 3 Prerequisite
- 4 Update the POS
- 4.1 1. Take a backup of your website
- 4.2 2. Turn on Maintenance
- 4.3 3. Turn off Magento Cron
- 4.4 4. Turn on Developer mode
- 4.5 5. Terminate the magestore_pos_process_order
- 4.6 6. Upload the package to Magento Root Directory
- 4.7 7. Extract the package and copy it to Magento Root Directory
- 4.8 8. Run upgrade command (Update POS)
- 4.9 9. Deploy POS client
- 4.10 10. Run code compilation
- 4.11 11. Install Magento Cron
- 4.12 12. Reindex All
- 4.13 13. Turn on Production mode
- 4.14 14. Turn off Maintenance
- 5 Summary
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
POS Simple >= v1.0.0
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.
8. Run upgrade command (Update POS)
9. Deploy POS client
This is a very important step: If you don’t run this command, you can’t access the POS application
10. Run code compilation
11. Install Magento Cron
12. Reindex All
13. Turn on Production mode
14. Turn off Maintenance
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.