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).
This guide applies to the brand new installation of Customized Magestore POS on your website (you don’t have any Magestore POS installed on your website yet). 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.
Please check the link below to make sure that the POS version you are having is compatible with your current Magento version.
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.
1. Take a backup of your website
The backup will help you recover faster in case that you are failed to install Magestore POS due to some conflict with other extensions or unexpected incidents while installing the POS.
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. Upload the package to Magento Root Directory
6. Extract the package to Magento Root Directory
cd <magento_root_directory> tar -xf <package_name>
7. Run upgrade (Install POS)
php bin/magento setup:upgrade
8. Deploy POS client
php bin/magento webpos:deploy
9. Run code compilation
php bin/magento setup:di:compile
10. Install Laminas Barcode
composer require laminas/laminas-barcode ^2.8 php bin/magento setup:upgrade
11. Addjust Redis session configuration
Note: This is an optional configuration if you are using Redis for Magento Session.
- Open file
app/etc/env.phpin your favorite editor
- Scroll down to
sessionsection as below
- Edit the value
max_concurrencyto a suitable number. Magento recommend we set that number by 10% of the number of PHP processes. If you don’t know that then try in the range from 6 to 24 is fine. For example 20.
12. Configure Message Queue
Note: Magestore POS default supported to work with Magento Message Queue with no special configuration needed (only need Magento Cron installed and running) if the POS you are having meets the below conditions
- POS Enterprise Commerce >= v4.8.0
- POS Enterprise >= v4.13.8
- POS Pro Commerce >= v4.5.0
- POS Pro >= v4.15.0
Read more: Configure Magento Message Queue
In case that you want to change the Message Broker to RabbitMQ so please follow the guide Configure Magestore POS to use RabbitMQ on Magento.
13. Install Magento Cron
php bin/magento cron:install
14. Reindex All
php bin/magento indexer:reindex
15. Turn on Production mode
php bin/magento deploy:mode:set production
16. Turn off Maintenance
php bin/magento maintenance:disable